Git MCP: три сервера и подключение к Claude Code, Codex и Cursor

modelcontextprotocol/servers· Проверено 12.11.2026· 91,9 тыс.на GitHub

Даёт агенту команды Git в локальном репозитории: статус, диффы, коммиты, ветки и слияния. Отдельный вариант GitMCP подтягивает документацию и код любого публичного проекта с GitHub.

3 реализации:

Эталонный сервер команды MCP на Python: 14 базовых команд, папку ограничивает флаг --repository, хуки и чужие драйверы репозитория не запускает.

Как подключить

Что сделать до подключения

uv с командой uvx; иначе pip install mcp-server-git или образ Docker mcp/git

Git 2.31 или новее

Имя и почта автора: user.name и user.email в Git или переменные GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio git \
  -- uvx mcp-server-git --repository '<путь к репозиторию>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.git]
command = "uvx"
args = ["mcp-server-git", "--repository", "<путь к репозиторию>"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "git": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "git": {
        "type": "local",
        "command": ["uvx", "mcp-server-git", "--repository", "<путь к репозиторию>"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "<путь к репозиторию>"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

git_statusпоказывает состояние рабочей копии

git_diff_unstagedпоказывает неиндексированные правки

git_diff_stagedпоказывает правки в индексе

git_diffсравнивает ветки и коммиты

git_addдобавляет файлы в индекс

git_commitделает коммит

git_resetснимает файлы с индекса

git_logчитает историю с фильтром дат

git_create_branchсоздаёт ветку

git_checkoutпереключает ветку

git_mergeсливает ветку в текущую

git_showпоказывает коммит или файл

git_branchперечисляет ветки

git_remoteпоказывает удалённые репозитории

28 команд вместе с push, pull, rebase, cherry-pick, stash и worktree; подписывает коммиты, работает по stdio и Streamable HTTP.

Как подключить

Что сделать до подключения

Node.js 20 или новее, либо Bun 1.2 или новее с командой bunx

Установленный Git: сервер вызывает его из командной строки

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env MCP_TRANSPORT_TYPE=stdio --env 'GIT_BASE_DIR=<папка с репозиториями>' --env 'GIT_USERNAME=<ваше имя>' --env 'GIT_EMAIL=<ваша почта>' --env GIT_SIGN_COMMITS=false --transport stdio git-mcp-server \
  -- npx @cyanheads/git-mcp-server@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.git-mcp-server]
command = "npx"
args = ["@cyanheads/git-mcp-server@latest"]

[mcp_servers.git-mcp-server.env]
MCP_TRANSPORT_TYPE = "stdio"
GIT_BASE_DIR = "<папка с репозиториями>"
GIT_USERNAME = "<ваше имя>"
GIT_EMAIL = "<ваша почта>"
GIT_SIGN_COMMITS = "false"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "git-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "git-mcp-server": {
        "type": "local",
        "command": ["npx", "@cyanheads/git-mcp-server@latest"],
        "environment": {
          "MCP_TRANSPORT_TYPE": "stdio",
          "GIT_BASE_DIR": "<папка с репозиториями>",
          "GIT_USERNAME": "<ваше имя>",
          "GIT_EMAIL": "<ваша почта>",
          "GIT_SIGN_COMMITS": "false"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "git-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/git-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "GIT_BASE_DIR": "<папка с репозиториями>",
        "GIT_USERNAME": "<ваше имя>",
        "GIT_EMAIL": "<ваша почта>",
        "GIT_SIGN_COMMITS": "false"
      }
    }
  }
}

Инструменты сервера

git_initсоздаёт репозиторий

git_cloneклонирует репозиторий

git_statusпоказывает состояние рабочей копии

git_addдобавляет файлы в индекс

git_commitделает коммит

git_diffсравнивает изменения

git_logчитает историю коммитов

git_blameпоказывает авторов строк

git_reflogчитает журнал ссылок

git_changelog_analyzeсобирает данные для changelog

git_branchуправляет ветками

git_checkoutпереключает ветку

git_mergeсливает ветки

git_rebaseперебазирует ветку

git_cherry_pickпереносит отдельные коммиты

git_fetchзабирает изменения с сервера

git_pullподтягивает и сливает изменения

git_pushотправляет коммиты на сервер

git_stashоткладывает правки

git_worktreeуправляет рабочими деревьями

Показано 20 из 28.

Облачный сервер без установки: по адресу gitmcp.io/<владелец>/<репозиторий> отдаёт агенту документацию и код публичного проекта с GitHub; с локальным Git не работает.

Как подключить

Что сделать до подключения

Ничего ставить не нужно: в клиенте прописывается адрес gitmcp.io/<владелец>/<репозиторий>, для любого проекта — gitmcp.io/docs

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http git-mcp https://gitmcp.io/<владелец>/<репозиторий>

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.git-mcp]
url = "https://gitmcp.io/<владелец>/<репозиторий>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "git-mcp": {
      "url": "https://gitmcp.io/<владелец>/<репозиторий>"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "git-mcp": {
      "type": "http",
      "url": "https://gitmcp.io/<владелец>/<репозиторий>"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "git-mcp": {
      "httpUrl": "https://gitmcp.io/<владелец>/<репозиторий>"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "git-mcp": {
      "httpUrl": "https://gitmcp.io/<владелец>/<репозиторий>"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "git-mcp": {
        "type": "remote",
        "url": "https://gitmcp.io/<владелец>/<репозиторий>"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://gitmcp.io/<владелец>/<репозиторий>

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "git-mcp": {
      "url": "https://gitmcp.io/<владелец>/<репозиторий>"
    }
  }
}

Инструменты сервера

fetch_<repo-name>_documentationчитает документацию проекта

search_<repo-name>_documentationищет по документации

search_<repo-name>_codeищет по коду репозитория

fetch_url_contentоткрывает ссылки из документации

Что попросить агента

«Посмотри, что я поменял, и закоммить с понятным сообщением»mcp-server-git вызовет git_status и git_diff_unstaged, добавит файлы через git_add и сделает git_commit

«Сравни ветку <имя ветки> с main и перечисли изменения»Агент вызовет git_diff с диапазоном main...<имя ветки> и разберёт дифф

«Какие коммиты были за последние 2 недели?»mcp-server-git вызовет git_log с start_timestamp «2 weeks ago»

«Перебазируй мою ветку на свежий main и отправь на сервер»git-mcp-server вызовет git_fetch, git_rebase и git_push

«Как пользоваться Playwright MCP? Документация: gitmcp.io/microsoft/playwright-mcp»GitMCP вызовет fetch_<repo-name>_documentation и search_<repo-name>_documentation и ответит по документации проекта

Для каких задач

Посмотреть, что изменилось в рабочей копии, и закоммитить нужные файлы

Сравнить две ветки или диапазон коммитов

Создать ветку, переключиться на неё и слить обратно

Найти в истории коммиты за период и показать файл на нужной ревизии

Отправить коммиты на сервер, перебазировать ветку или перенести отдельный коммит

Дать агенту свежую документацию библиотеки с GitHub, чтобы он писал код по ней

Ограничения

mcp-server-git без флага --repository читает и меняет любой репозиторий, до которого дотянется процесс; сам сервер в ранней разработке, набор команд может меняться

У mcp-server-git нет push, pull и clone: для работы с удалённым репозиторием нужен git-mcp-server

git-mcp-server по умолчанию подписывает коммиты GPG или SSH; если подпись не удалась, коммит уходит неподписанным

GitMCP видит только публичные репозитории GitHub и работает через облако gitmcp.io

Если не работает

Любой вызов mcp-server-git падает с ошибкой о версии Git

Серверу нужен Git 2.31 или новее: обновите Git.

Коммиты из Docker записаны на имя вроде app <app@3f2a1b9c8d7e>

В контейнере нет вашего .gitconfig: передайте GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_COMMITTER_NAME и GIT_COMMITTER_EMAIL через -e или смонтируйте .gitconfig в /home/app/.gitconfig.

На Linux сервер в Docker не может писать в репозиторий

Добавьте перед mcp/git аргументы --user с вашими id -u и id -g, например 1000:1000.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
mcp-server-git	Model Context Protocol	91,9 тыс.	локально	не нужен	14	12 ноября 2026
git-mcp-server	cyanheads	245	локально	не нужен	28	26 сентября 2026
GitMCP	idosal	8,5 тыс.	HTTP	не нужен	4	8 мая 2026

Частые вопросы

Какой Git-сервер выбрать?

Для повседневной работы в одном репозитории хватит mcp-server-git: статус, диффы, коммиты, ветки и слияние. Если агент должен сам делать push, pull, rebase или stash, ставьте git-mcp-server. GitMCP нужен для другого: он отдаёт агенту документацию чужих проектов с GitHub.

Как не дать агенту трогать чужие репозитории?

У mcp-server-git укажите флаг --repository с путём к проекту: тогда вызовы вне этого репозитория отклоняются. У git-mcp-server ту же роль играет переменная GIT_BASE_DIR.

Чьё имя попадёт в коммит?

mcp-server-git берёт автора так же, как git commit: из переменных GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL, GIT_COMMITTER_NAME, GIT_COMMITTER_EMAIL или из user.name и user.email в настройках Git. Без них он подставит имя пользователя системы и хоста. git-mcp-server читает GIT_USERNAME и GIT_EMAIL, иначе глобальный конфиг Git.

Запустит ли сервер хуки репозитория?

mcp-server-git хуки не запускает: core.hooksPath указывает в пустоту, внешние диффы, фильтры и драйверы слияния из настроек самого репозитория отключены. Драйверы из вашего глобального конфига, например Git LFS, продолжают работать.

GitMCP платный?

Нет, сервис бесплатный, регистрации не требует и запросы агентов не хранит. Его можно развернуть у себя: код открыт.

Что такое GitMCP и чем он отличается от Git MCP?

GitMCP — облачный сервер по адресу gitmcp.io: он отдаёт агенту документацию и код публичного проекта с GitHub. С локальным репозиторием и командами Git он не работает, для этого нужны mcp-server-git или git-mcp-server.

Как подключить Git MCP к Claude Code?

Откройте вкладку Claude Code в блоке «Как подключить»: там команда для mcp-server-git с флагом --repository. Путь замените на папку своего проекта.

Работает ли сервер из России?

mcp-server-git и git-mcp-server работают на вашем компьютере без аккаунтов; GitMCP обращается к облаку gitmcp.io и регистрации не требует.

Git MCP: три сервера и подключение к Claude Code, Codex и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы