GitHub Tools MCP Server

Настоящий сервер Model Context Protocol, предоставляющий инструменты только для чтения для GitHub REST API — устанавливается в Claude Desktop или Claude Code менее чем за минуту — плюс отдельное веб-демо, использующее ту же логику инструментов через обычный чат-интерфейс.

Онлайн-демо: https://mcp-demo-phi.vercel.app/demo

Статус: что это и чем не является

Работает и развёрнуто. Все 5 инструментов проверены на реальных данных GitHub, 42 автоматизированные проверки в 3 тестовых наборах, а полное приложение подтверждено живым на реальном боевом URL. Подробный честный отчёт о каждом решении и ошибке на пути — в DESIGN_LOG.md.

Веб-демо — это НЕ MCP-транспорт. Это обычный FastAPI, который вызывает те же функции tools.py напрямую из Python, а не говорит по протоколу MCP. Это действительно полезное различие, и в нём стоит быть точными — см. раздел 3 в DESIGN_LOG.md о том, почему здесь не реализуется настоящий удалённый MCP-транспорт.

Related MCP server: GitHub MCP Connector

Архитектура

                    ┌─────────────────────┐
                    │      tools.py        │  <- 5 pure functions, no
                    │  (GitHub REST calls   │     MCP-specific code
                    │   via github_client)   │
                    └──────────┬───────────┘
                               │
              ┌────────────────┴────────────────┐
              │                                  │
    ┌─────────▼─────────┐            ┌───────────▼──────────┐
    │     server.py       │            │     api/index.py       │
    │  MCPServer, stdio    │            │  FastAPI, POST /chat    │
    │  transport            │            │  real Claude tool-      │
    │  -> Claude Desktop/    │            │  calling loop over       │
    │     Claude Code        │            │  the same tools           │
    └─────────────────────┘            └────────────────────────┘
     THE MCP SERVER                      A PLAIN HTTP DEMO OF
     (the real deliverable)              THE SAME TOOL LOGIC

Настройка

cp .env.example .env   # GITHUB_TOKEN (both halves), ANTHROPIC_API_KEY (web demo only)
pip install -r requirements.txt

Запуск MCP-сервера локально

python3 server.py

Добавление в Claude Desktop: отредактируйте %APPDATA%\Claude\claude_desktop_config.json (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), объединив содержимое файла claude_desktop_config.example.json (подставьте ваш реальный GITHUB_TOKEN и абсолютный путь к server.py), затем перезапустите Claude Desktop. Добавление в Claude Code: выполните claude mcp add или отредактируйте .mcp.json вашего проекта таким же образом.

Ручной интерактивный процесс разработки: в SDK есть инспектор для ручного взаимодействия с сервером без полноценного клиента — npx @modelcontextprotocol/inspector python3 server.py.

Запуск веб-демо локально

export $(cat .env | xargs)
uvicorn api.index:app --reload --port 8020

Журнал проектирования

Каждое неочевидное решение, а также реальная API-поверхность SDK, проверенная по фактически установленному пакету, а не взятая из возможно устаревшей документации, — в DESIGN_LOG.md.