gh-mcp CLI
gh-mcp запускает GitHub MCP-сервер как расширение gh на вашем входе GitHub CLI, без личного токена в настройках клиента.
- 54 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент действует с правами вашего входа в `gh` над репозиториями и обращениями.
- Режим `--read-only` и список `--toolsets` сужают права, но по умолчанию доступно больше.
Установка
- Работает в
Ручная установка
gh extension install shuymn/gh-mcpРаздел Installation из README. Нужен авторизованный GitHub CLI (`gh auth login`).
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент действует с правами вашего входа в `gh` над репозиториями и обращениями.
- Режим `--read-only` и список `--toolsets` сужают права, но по умолчанию доступно больше.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gh-mcp — расширение GitHub CLI, которое запускает официальный `github-mcp-server` как встроенный бинарный файл. Учетные данные берутся из `gh auth login`, поэтому не нужно создавать и хранить токен доступа для MCP-клиента. В настройках клиента достаточно записи `command: gh`, `args: [mcp]`. Флаги `--toolsets=repos,issues,pull_requests` ограничивают набор инструментов, а `--read-only` оставляет только чтение. Для Claude Code есть готовая команда `claude mcp add-json github`. Бинарные файлы выпущены для macOS, Linux и Windows на архитектурах amd64, arm64 и 386.
Для кого. Разработчикам, которые уже вошли в `gh` и хотят подключить GitHub MCP к агенту, не заводя отдельный токен.
Подходит, если
- Нужно подключить GitHub MCP к Claude Code, а токен не хочется выпускать вручную.
- Агенту надо дать только чтение репозиториев и issue через `--read-only`.
- Набор инструментов нужно сузить до репозиториев, обращений и запросов на слияние.
- Одна и та же настройка нужна на нескольких машинах с разной ОС.
Не подходит, если
- Вход через `gh` не настроен и недоступен.
- Нужен удаленный HTTP-сервер MCP, а не локальный процесс.
- Требуется отдельная учетная запись с урезанными правами, а не ваш вход.
Пример запроса к агенту
Подключи GitHub MCP только для чтения и покажи открытые issue этого репозитория.Ограничения
Нужен установленный и авторизованный GitHub CLI. Агент действует с правами вашего входа в `gh`: ограничивайте набор инструментов флагами `--toolsets` и `--read-only`. Выпущены сборки для восьми платформ, на которых публикует архивы официальный сервер. Обновление выполняет `gh extension upgrade mcp`. Сам сервер остается официальным, расширение лишь запускает его. Расширение принадлежит стороннему автору, а не GitHub: проверьте его исходники перед установкой.
Как отключить. Удалите расширение командой `gh extension remove mcp` и запись `github` из настроек MCP-клиента.
Частые вопросы
Как установить?
Выполните `gh extension install shuymn/gh-mcp`. Нужен авторизованный `gh`. Обновляет расширение `gh extension upgrade mcp`.
Как добавить в Claude Code?
Выполните `claude mcp add-json github '{"command":"gh","args":["mcp"]}'`. Флаги вроде `--read-only` добавляют в массив `args`.
Как ограничить права агента?
Используйте `--read-only` и список `--toolsets`, например `repos,issues`. Права входа `gh` при этом остаются верхней границей.
Нужен ли токен доступа?
Нет, расширение берет учетные данные у `gh`. Вход выполняют командой `gh auth login`.
На каких платформах работает?
На macOS, Linux и Windows, на архитектурах amd64, arm64 и 386, где их публикует апстрим.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыclihub превращает любой MCP-сервер в готовый CLI: каждый инструмент становится подкомандой, а на выходе один статический бинарник без зависимостей
MCP-сервер git на 28 инструментов: агент клонирует, коммитит, ветвит, сливает и перебазирует в локальных репозиториях.
Официальный MCP-сервер GitKraken из CLI gk: git, репозитории, pull request и задачи в GitHub, GitLab, Bitbucket и Jira
Консольный отладчик MCP-серверов от Giant Swarm: REPL для инструментов, OAuth 2.1 и режим MCP-сервера для Cursor
Удаленный MCP-сервер, который отдает агенту документацию и код любого публичного GitHub-репозитория без установки
MCP для GitFlic поверх gitflic-cli
gitflic-cli MCP-сервер
MCP-сервер с 76 типизированными инструментами поверх CLI для GitFlic: слияния, задачи, релизы, реестр пакетов, с фильтрами групп и read-only режимом
Коротко о README
Расширение убирает ручную работу с токеном: подключение к MCP-клиенту занимает одну запись, а права определяет вход в `gh`.