GitHub MCP Server

Что умеет сервер

GitHub MCP Server выпускает сам GitHub. Он связывает AI-клиент с платформой: агент может читать репозитории и файлы, искать по коду, создавать и обновлять issues и pull request, разбирать падения в GitHub Actions, смотреть находки сканирования кода и оповещения Dependabot, работать с обсуждениями и уведомлениями.

Инструменты сгруппированы в наборы (toolsets): context, repos, issues, pull_requests, users, actions, code_security, dependabot, discussions, gists, projects и другие. По умолчанию включены пять: context, repos, issues, pull_requests и users. Остальные добавляют в конфигурации сервера, например GITHUB_TOOLSETS="default,stargazers".

Как подключить и когда использовать

Есть два варианта. Удалённый сервер размещает сам GitHub, это самый простой путь: в клиенте достаточно указать адрес и авторизоваться через OAuth или персональный токен. Локальный сервер запускается у вас в Docker или как бинарный файл и подходит, если клиент не умеет удалённые MCP-серверы, а также для GitHub Enterprise Server, который удалённый вариант не поддерживает.

Сервер полезен, когда в задаче много обращений к GitHub: разобрать очередь issues и предложить приоритеты, подготовить описание pull request по диффу, найти причину красной сборки, свести открытые уязвимости в список. Для разовой правки файла в локальной копии репозитория он избыточен.

Ограничения и безопасность

Агент действует с правами вашего токена или OAuth-входа. Всё, что доступно токену, доступно и модели, поэтому выдавайте минимально нужные права. В руководстве по токенам приводятся такие минимальные области: repo для операций с репозиториями, read:packages для скачивания Docker-образа и read:org для команд организации. Токен не стоит хранить в репозитории, а для разных проектов лучше заводить разные.

Если запись не нужна, включите режим только для чтения (--read-only или переменная GITHUB_READ_ONLY=1): сервер тогда не предлагает инструменты, которые что-то меняют. Режим lockdown скрывает из публичных репозиториев материалы авторов без прав на запись и снижает риск внедрения инструкций через чужие issues и комментарии. В README он назван фильтром по возможности, а не границей авторизации: права токена он не меняет.

Claude Desktop удалённый сервер GitHub по руководству пока не подключает: для него требуется OAuth через зарегистрированное приложение, и рекомендован локальный запуск в Docker. Там же отмечены сообщения о проблемах Claude Desktop с серверами в Docker.

Удалённый сервер в VS Code (версия 1.101 и новее)

Через OAuth:

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Через персональный токен (PAT):

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:github_mcp_pat}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "github_mcp_pat",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

Claude Code, удалённый сервер

Команда выполняется в терминале, не внутри Claude Code. Для Claude Code 2.1.1 и новее:

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

Для более старых версий:

claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"

После добавления перезапустите Claude Code и проверьте сервер:

claude mcp list
claude mcp get github

Claude Code, локальный сервер (нужен Docker)

Вход через OAuth, браузер откроется при первом использовании:

claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server

Вход через персональный токен (он приоритетнее OAuth):

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Claude Desktop (локальный сервер в Docker)

Файл claude_desktop_config.json: Windows %APPDATA%\Claude\, macOS ~/Library/Application Support/Claude/. Вариант с OAuth:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p",
        "127.0.0.1:8085:8085",
        "-e",
        "GITHUB_OAUTH_CALLBACK_PORT",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_OAUTH_CALLBACK_PORT": "8085"
      }
    }
  }
}

Вариант с токеном:

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
      }
    }
  }
}

После правки конфигурации перезапустите Claude Desktop.

Режим только для чтения

docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
  -e GITHUB_READ_ONLY=1 \
  ghcr.io/github/github-mcp-server

Установка в Cursor, Windsurf, Codex, Zed и другие клиенты описана в руководствах репозитория (каталог docs/installation-guides).