Skip to main content
Glama
deenesjakoruzh
charlesnpx

GitHub MCP

by charlesnpx
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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 Code Search 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

Инструмент

Назначение

list_repositories

Список репозиториев, выбранных в установках приложения.

search_code

Поиск внутри одного установленного репозитория.

list_directory

Вывод содержимого одного каталога репозитория на указанном ref.

get_file

Получение UTF-8 текстового файла, при необходимости по диапазону строк.

list_commits / get_commit

Просмотр истории репозитория.

list_pull_requests / get_pull_request

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

get_pull_request_diff

Получение unified diff пул-реквеста.

list_issues / get_issue

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

Результаты — это живые ответы 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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers