MCP-сервер для GitHub

MCP-сервер для GitHub — это приложение, которое предоставляет AI-ассистентам доступ к GitHub через стандартный протокол Model Context Protocol (MCP). Сервер разворачивается на виртуальной машине в Yandex Cloud.

Основные возможности и преимущества

• Интеграция с Yandex AI Studio. MCP-сервер интегрируется с AI Studio MCP Серверы — подключите его к вашим AI-агентам в несколько кликов.
• Управление репозиториями. Позволяет AI-ассистентам создавать репозитории, форки, ветки, искать репозитории и просматривать содержимое файлов.
• Работа с задачами и запросами на слияние. Создание задач GitHub, запросов на слияние, комментариев и управление ими через естественный язык.
• Поиск кода и просмотр коммитов. Поиск кода, пользователей и задач по всему GitHub, а также просмотр коммитов репозитория с помощью AI-ассистента.
• Авторизация Bearer-токеном. Все запросы к MCP-серверу защищены Bearer-токеном, который хранится в Yandex Lockbox.
• Безопасное хранение секретов. Персональный токен доступа GitHub хранится в Yandex Lockbox и извлекается при запуске.
• Стандартный протокол MCP. Использует открытый протокол Model Context Protocol для взаимодействия с AI-моделями.
• Транспорт Streamable HTTP. MCP-сервер доступен на порту 8000 (Streamable HTTP).
• Конфигурация виртуальной машины. Приложение работает на виртуальной машине с фиксированной конфигурацией: 2 vCPU и 2 ГБ оперативной памяти.
• Docker-контейнеризация. Сервер запускается в Docker-контейнерах (MCP + supergateway + nginx auth proxy).

Подключение к MCP-серверу использует HTTP без шифрования. Bearer-токен авторизует запросы, но не шифрует соединение. Для подключения используйте внутренний URL MCP-сервера и обеспечьте сетевой доступ к ВМ. Не передавайте Bearer-токен через публичный HTTP-адрес.

1. Убедитесь, что у вас есть учётная запись GitHub.
2. Создайте персональный токен доступа (Personal Access Token) в GitHub с необходимыми правами доступа к репозиториям.
3. Создайте секрет в Yandex Lockbox для хранения персонального токена доступа GitHub. Секрет должен содержать ключ personal_access_token со значением токена.
4. Создайте секрет в Yandex Lockbox для хранения Bearer-токена авторизации. Секрет должен содержать ключ bearer_token с произвольным токеном.
5. Создайте сервисный аккаунт для установки приложения и назначьте ему на каталог установки роли compute.editor, iam.serviceAccounts.admin, vpc.admin.
6. Назначьте установочному сервисному аккаунту роль lockbox.admin отдельно на секрет с Bearer-токеном и на секрет с учётными данными внешнего сервиса. Роль нужна для чтения и изменения прав доступа к выбранным секретам; назначать её на каталог не требуется. Это правило действует и для секретов из другого каталога. При установке приложение создаст отдельный сервисный аккаунт ВМ и назначит ему lockbox.payloadViewer только на выбранные секреты.
7. В консоли управления выберите сервис Cloud Apps.
8. На панели слева выберите Магазин приложений.
9. Выберите MCP GitHub и нажмите кнопку Использовать.
10. Укажите:
    • Имя приложения.
    • (Опционально) Описание приложения.
    • Сервисный аккаунт, созданный ранее.
    • Облачную подсеть, в которой будет развёрнута виртуальная машина.
    • Идентификатор секрета Lockbox с Bearer-токеном для авторизации.
    • Идентификатор секрета Lockbox с персональным токеном доступа GitHub.
    • Внешний доступ к MCP-серверу (опционально; по умолчанию выключен, включите для подключения по публичному IP-адресу).
    • SSH-доступ: выберите «Отключён», если подключение по SSH не требуется. При выборе «Включён» укажите имя пользователя и публичный SSH-ключ. При включении SSH приложение разрешает входящие подключения на TCP-порт 22 из интернета.
11. Нажмите кнопку Установить и дождитесь, пока приложение установится.
12. После установки скопируйте полный адрес из раздела Данные приложения, поле URL MCP-сервера (внутренний): http://<private-ip>:8000/mcp. Для подключения клиенту нужен сетевой доступ к внутреннему IP-адресу ВМ.
13. Настройте ваш AI-клиент для подключения к MCP-серверу, указав заголовок Authorization: Bearer <ваш-токен>.

Подключение MCP-сервера к Yandex AI Studio

1. В консоли управления откройте сервис AI Studio и перейдите в раздел Agent Core → MCP-серверы.
2. Нажмите Создать MCP-сервер и в разделе MCP-серверы из Yandex Cloud Marketplace выберите нужный MCP-сервер.
3. Укажите имя сервера и выберите уже развёрнутый экземпляр приложения или создайте новый, следуя инструкциям по развёртыванию. При развёртывании нового сервера кнопка Сохранить будет доступна только после полного развёртывания и запуска MCP-сервера.
4. После выбора приложения значения параметров Сеть и Сервисный аккаунт MCP-сервера заполнятся автоматически.
5. Нажмите Создать. После успешной проверки подключения выберите необходимые инструменты (tools) и нажмите Сохранить — MCP-сервер будет зарегистрирован в AI Studio и доступен для использования AI-агентами.

• Поиск репозиториев на GitHub с помощью AI-ассистента.
• Создание задач GitHub и запросов на слияние через естественный язык.
• Просмотр и анализ содержимого файлов в репозиториях.
• Поиск кода, пользователей и задач GitHub; просмотр коммитов репозитория.
• Управление ветками и форками репозиториев через AI-ассистента.

Служба технической поддержки Yandex Cloud отвечает на запросы 24 часа в сутки, 7 дней в неделю. Доступные виды запросов и срок их обработки зависят от тарифного плана. Подключить платную поддержку можно в консоли управления. Подробнее о порядке оказания технической поддержки.