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 для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники