com.github-mcp.json

{
  "$schema": "../schemas/server-definition.schema.json",
  "id": "com.github-mcp",
  "name": "GitHub",
  "alias": "gh",
  "description": "Interact with GitHub repositories, issues, pull requests, actions, and code security through the official GitHub MCP server.",
  "icon": "https://avatars.githubusercontent.com/u/9919?v=4",
  "schema_version": "2.1",
  "categories": ["developer-tools", "version-control"],
  "tags": ["git", "github", "code", "issues", "pull-requests", "repos", "actions", "code-review"],

  "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 the GitHub API. Requires repo and read:org scopes.",
          "type": "text",
          "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 personal access token at https://github.com/settings/tokens with repo and read:org scopes"
  },

  "contributor": {
    "name": "GitHub",
    "github": "github",
    "url": "https://github.com"
  },

  "links": {
    "repository": "https://github.com/github/github-mcp-server",
    "homepage": "https://github.com",
    "documentation": "https://github.com/github/github-mcp-server#readme"
  },

  "platforms": ["all"],

  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": true,
    "read_only_mode": false
  },

  "changelog_url": "https://github.com/github/github-mcp-server/releases"
}