GitHub MCP Server (кастомный)

Кастомный сервер Model Context Protocol (MCP), дающий AI-агенту полный CRUD-доступ к GitHub: репозитории, issues, pull requests, ветки, комментарии, ревью и слияния. Создан с использованием официального Python mcp SDK (FastMCP) и REST API GitHub через httpx.

Всего 23 инструмента — полный список в server.py. Основные:

Настройка

1. Установите зависимости

   pip install -r requirements.txt

2. Создайте GitHub-токен

   Перейдите на https://github.com/settings/tokens и создайте либо:

   • классический PAT с областью repo, либо

   • fine-grained PAT с Contents, Issues, Pull requests и Metadata, установленными на Read & write, с областью действия на репозитории, к которым агенту нужен доступ.

3. Задайте токен как переменную окружения

   export GITHUB_TOKEN=ghp_your_token_here

4. Запустите его отдельно (необязательная проверка работоспособности)

   python server.py

   Он будет ждать подключения MCP-клиента через stdio — это ожидаемо, это не веб-сервер.

Related MCP server: GitHub MCP Server

Подключение к Claude Desktop

Добавьте это в ваш claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json в Windows, ~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "github": {
      "command": "python",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Перезапустите Claude Desktop, и инструменты GitHub появятся в списке инструментов.

Подключение к вашему собственному пайплайну агента (например, проект Jira → GitHub → Teams)

Поскольку это стандартный MCP stdio-сервер, любой MCP-совместимый клиент или SDK может запустить его как подпроцесс и общаться с ним через stdin/stdout — включая .NET-хост, если вы используете MCP C# SDK, или Python/TypeScript SDK, если ваш оркестратор полиглот. Укажите клиенту на:

command: python
args: ["/absolute/path/to/server.py"]
env: { "GITHUB_TOKEN": "<token>" }

Расширение

Чтобы добавить новый инструмент, просто добавьте новую функцию с декоратором @mcp.tool() в server.py, которая вызывает _request(method, path, ...) против GitHub REST API. Docstring становится описанием инструмента, показываемым модели, а аннотации типов становятся схемой входных данных — поэтому держите оба точными.

Примечания

• Все операции записи (create_*, update_*, delete_*, merge_*) вносят реальные изменения на GitHub — режима dry-run нет. Рекомендуется тестировать на тестовом репозитории, особенно merge_pull_request и delete_branch.

• Лимиты запросов соответствуют стандартным лимитам REST API GitHub (5 000 запросов в час для аутентифицированных запросов на момент написания) — сервер не выполняет собственного троттлинга.

• Ошибки от GitHub (неверная аутентификация, 404, конфликты слияния и т.д.) выбрасываются как RuntimeError с включённым телом ответа API, чтобы вызывающий агент получил читаемое сообщение для реакции.