GitHub MCP

Универсальный удалённый MCP-коннектор только для чтения для запросов к репозиториям GitHub, выбранным с помощью установки GitHub App. Он предназначен для самостоятельного развёртывания и не содержит идентификаторов учётных записей GitHub, Cloudflare или MCP-клиентов.

Коннектор использует два уровня авторизации:

1. Пользователь авторизует GitHub App, чтобы подтвердить свою учётную запись GitHub. Завершить подключение могут только логины, настроенные оператором.

2. Вызовы инструментов используют кратковременные токены установки GitHub App, ограниченные запрошенным установленным репозиторием.

Пользовательский токен GitHub отбрасывается после подтверждения личности. Коннектор не предоставляет инструментов для записи.

Возможности

• Обнаружение репозиториев, выбранных в установках GitHub App.

• Поиск кода и получение текстовых файлов или списков каталогов.

• Просмотр коммитов, пул-реквестов, диффов, ревью и комментариев.

• Просмотр issues и комментариев к ним.

• Аутентификация удалённых MCP-клиентов с помощью OAuth, PKCE и Dynamic Client Registration.

Related MCP server: GitHub MCP Server

Локальная разработка

Требования: Node 22 или новее и Yarn 1.22.

yarn install
yarn type-check
yarn lint
yarn test
yarn build

В тестах используются фиктивные учётные записи и имитации сервисов GitHub. Для локальной проверки не нужна учётная запись GitHub App или Cloudflare.

Чтобы запустить Worker с реальными сервисами, следуйте руководству по настройке оператора. Не фиксируйте wrangler.jsonc, локальные секреты или приватные ключи GitHub App.

Инструменты MCP

Результаты — это живые ответы GitHub API, нормализованные в ограниченный JSON с каноническими URL GitHub. Пагинация по умолчанию возвращает 20 элементов, максимум — 50. Максимальный размер текстового и diff-вывода — 100 000 символов.

Модель безопасности

• AUTHORIZED_GITHUB_LOGINS — обязательный параметр; при пустом значении доступ закрыт по умолчанию (fail closed).

• Установки GitHub App определяют, какие репозитории доступны коннектору.

• Каждый вызов инструмента для работы с репозиторием создаёт одночасовой токен, ограниченный этим репозиторием.

• Требуемые разрешения GitHub App дают доступ только на чтение к Metadata, Contents, Issues и Pull Requests.

• OAuth-коды, пользовательские токены, токены установки, секреты клиентов и приватные ключи никогда не возвращаются и намеренно не логируются.

Этот проект задуман как коннектор для личного использования или небольшой команды, а не как размещённый мультитенантный сервис.

Лицензия

Этот проект распространяется по лицензии MIT.