complete-example.json

{
  "$schema": "../schemas/server-definition.schema.json",
  "id": "com.github-mcp",
  "name": "GitHub",
  "alias": "gh",
  "description": "Interact with GitHub repositories, issues, pull requests, and more through the GitHub API.",
  "logo": "https://avatars.githubusercontent.com/u/9919?v=4",
  "schema_version": "2.1",
  "categories": [
    "developer-tools",
    "version-control"
  ],
  "tags": [
    "git",
    "code",
    "issues",
    "pr",
    "repos"
  ],
  "transport": {
    "type": "stdio",
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "GITHUB_PERSONAL_ACCESS_TOKEN",
      "ghcr.io/github/github-mcp-server"
    ],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:GITHUB_TOKEN}"
    },
    "metadata": {
      "inputs": [
        {
          "id": "GITHUB_TOKEN",
          "label": "GitHub Personal Access Token",
          "description": "Token used to authenticate with GitHub API",
          "type": "password",
          "required": true,
          "secret": true,
          "placeholder": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "obtain": {
            "url": "https://github.com/settings/tokens/new",
            "instructions": "1. Click 'Generate new token (classic)'\n2. Give it a name like 'McpMux'\n3. Select scopes: repo, read:org\n4. Click 'Generate token'\n5. Copy the token (starts with ghp_)",
            "button_label": "Create Token"
          }
        }
      ]
    }
  },
  "auth": {
    "type": "api_key",
    "instructions": "Create a token at https://github.com/settings/tokens with repo scope"
  },
  "contributor": {
    "name": "Model Context Protocol",
    "github": "modelcontextprotocol",
    "url": "https://modelcontextprotocol.io"
  },
  "links": {
    "repository": "https://github.com/modelcontextprotocol/servers",
    "documentation": "https://modelcontextprotocol.io/docs"
  },
  "platforms": [
    "all"
  ],
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": false,
    "read_only_mode": false
  }
}