git-mcp-server
git-mcp-server — MCP-сервер сообщества (автор — cyanheads). Git-сервер с полным набором команд: clone, commit, worktree и другие. Ставится через npx. Лицензия Apache-2.0.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- cyanheads
- Лицензия
- Apache-2.0
- Транспорт
- stdio, streamable_http
- Авторизация
- oauth
- ОС
- Не указана
- Языки
- typescript
Уровень риска: high
Выполняет git с записью, включая reset, rebase и push. Разрушительные операции требуют явных флагов. Задайте `GIT_BASE_DIR`, в HTTP-режиме включите jwt или oauth (по умолчанию авторизация выключена).
Что умеет
@cyanheads/git-mcp-server — MCP-сервер, который даёт ИИ-ассистенту полный набор операций git. В нём 28 инструментов в семи группах: от git status и коммитов до rebase, cherry-pick, worktree и отправки изменений на удалённый сервер. Работает на Node.js или Bun, по stdio или Streamable HTTP.
- Репозиторий:
git_init,git_clone,git_status,git_clean. - Индекс и коммиты:
git_add,git_commit,git_diff. - История:
git_log,git_show,git_blame,git_reflog. - Ветки и слияния:
git_branch,git_checkout,git_merge,git_rebase,git_cherry_pick. - Удалённые репозитории:
git_remote,git_fetch,git_pull,git_push. - Продвинутые сценарии:
git_tag,git_stash,git_reset,git_worktreeи выбор рабочей папки сессии. - Анализ:
git_changelog_analyzeсобирает контекст для подготовки changelog.
Есть ресурс git://working-directory с текущей рабочей папкой и промпт Git Wrap-up: он ведёт ассистента по завершению сессии (проверка, документация, коммит и тег).
Кому подойдёт
- Разработчику, который хочет отдавать агенту рутину git: коммиты, ветки, теги, разбор истории.
- Командам с подписью коммитов: сервер по умолчанию подписывает коммиты, слияния и теги через GPG или SSH.
- Тем, кто разворачивает MCP на сервере: есть HTTP-режим с JWT или OAuth и сборка для Cloudflare Workers.
Если нужен только просмотр репозитория без записи, посмотрите эталонный Git MCP. Другие варианты — в категории разработка и в подборке MCP для GitHub.
Установка
Сервер запускается без установки:
npx @cyanheads/git-mcp-server@latestДля Bun используйте bunx @cyanheads/git-mcp-server@latest. Нужен Node.js 20 или новее либо Bun 1.2 или новее.
Основные переменные окружения:
GIT_BASE_DIR— ограничивает все операции указанным деревом папок.GIT_AUTHOR_NAMEиGIT_AUTHOR_EMAIL(илиGIT_USERNAMEиGIT_EMAIL) — автор коммитов. Без них берутся данные из глобального конфига git.GIT_SIGN_COMMITS— подпись коммитов, по умолчаниюtrue.MCP_TRANSPORT_TYPE—stdioилиhttp. Для HTTP порт по умолчанию 3015, адрес 127.0.0.1.
Подключение к клиентам
README даёт один общий конфиг в формате mcpServers и приводит в пример файл cline_mcp_settings.json. В оригинале указаны имя и почта автора проекта, замените их на свои. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"git-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["@cyanheads/git-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"GIT_BASE_DIR": "~/Developer/",
"LOGS_DIR": "~/Developer/logs/git-mcp-server/",
"GIT_USERNAME": "your-name",
"GIT_EMAIL": "you@example.com",
"GIT_SIGN_COMMITS": "true"
}
}
}
}Для HTTP задайте MCP_TRANSPORT_TYPE=http и MCP_HTTP_PORT=3015.
Проверка
Попросите ассистента показать статус репозитория. Он должен вызвать git_set_working_dir, а затем git_status. Если сервер отвечает ошибкой пути, проверьте, что папка лежит внутри GIT_BASE_DIR.
Риски
Сервер выполняет команды git с записью: коммиты, слияния, rebase, reset и push в удалённый репозиторий. По README разрушительные операции (git clean, git reset --hard) требуют явных флагов подтверждения. Пути проверяются против выхода за пределы папки, команды запускаются без интерполяции в shell.
Как снизить риски: задайте GIT_BASE_DIR, работайте в отдельной ветке, проверяйте diff перед push. В HTTP-режиме включайте jwt или oauth, по умолчанию авторизация выключена. Лицензия — Apache-2.0.
Частые вопросы
Чем отличается от эталонного сервера git?
У этого сервера больше операций: push, pull, rebase, cherry-pick, worktree, теги и подпись коммитов. Есть HTTP-режим с авторизацией.
Можно ли запретить доступ к другим папкам?
Да. Переменная GIT_BASE_DIR ограничивает все операции одним деревом папок.
Подписываются ли коммиты?
По умолчанию да, через GPG или SSH. Если подписать не удалось, коммит создаётся без подписи, а в ответе приходит предупреждение.
Основы протокола — на странице что такое MCP-сервер.
Инструменты
- git_status
- git_log
- git_diff
- git_blame
- git_add
- git_commit
- git_branch
- git_merge
- git_rebase
- git_push
- git_reset
- git_tag
Похожие MCP-серверы
GitHub MCP Server
Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.
Git
Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.
GitDiagram
Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.
git-mcp
Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.