git-mcp-server — MCP-сервер для Claude Code: что делает и установка
Даёт ИИ-агенту доступ к 28 операциям Git: от создания веток и коммитов до анализа истории изменений и работы с worktree. Помогает передать версионирование кодовой базы ассистенту.
claude mcp add --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env GIT_BASE_DIR=<GIT_BASE_DIR> --env MCP_HTTP_HOST=<MCP_HTTP_HOST> --env MCP_HTTP_PORT=<MCP_HTTP_PORT> --env MCP_HTTP_ENDPOINT_PATH=<MCP_HTTP_ENDPOINT_PATH> --transport stdio git-mcp-server -- npx -y @cyanheads/git-mcp-serverЧто делает git-mcp-server
Сервер предоставляет ассистенту набор из 28 инструментов для прямой работы с репозиторием. Среди них есть создание коммитов, переключение веток и cherry-pick. Для разбора истории предусмотрены git_blame и функция git_changelog_analyze. Она собирает контекст для формирования чейнджлога.
В состав входят ресурс git://working-directory и сценарий Git Wrap-up. Он помогает завершить сессию, сделать коммит и проставить теги. Сервер работает через протоколы stdio или Streamable HTTP.
Для запуска нужен Node.js от версии 20.0.0 либо Bun от 1.2.0. Среда определяется автоматически. Без переменных GIT_USERNAME и GIT_EMAIL в конфиге создание коммитов завершится ошибкой.
Какие задачи решает
- Передать агенту создание коммитов, веток и слияние изменений
- Проверить историю правок и авторство строк через blame
- Собрать контекст коммитов для подготовки чейнджлога
- Изолировать параллельные эксперименты с помощью
git_worktree
Примеры запросов агенту
- Сделай коммит всех изменённых файлов с сообщением «fix: update auth flow»
- Посмотри через
git_logпоследние пять коммитов и объясни изменения - Подготовь список правок с помощью
git_changelog_analyzeдля нового релиза
Как установить git-mcp-server
Командой платформы
claude mcp add --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env GIT_BASE_DIR=<GIT_BASE_DIR> --env MCP_HTTP_HOST=<MCP_HTTP_HOST> --env MCP_HTTP_PORT=<MCP_HTTP_PORT> --env MCP_HTTP_ENDPOINT_PATH=<MCP_HTTP_ENDPOINT_PATH> --transport stdio git-mcp-server -- npx -y @cyanheads/git-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add git-mcp-server --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env GIT_BASE_DIR=<GIT_BASE_DIR> --env MCP_HTTP_HOST=<MCP_HTTP_HOST> --env MCP_HTTP_PORT=<MCP_HTTP_PORT> --env MCP_HTTP_ENDPOINT_PATH=<MCP_HTTP_ENDPOINT_PATH> -- npx -y @cyanheads/git-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"git-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/git-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"GIT_BASE_DIR": "<GIT_BASE_DIR>",
"MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<MCP_HTTP_ENDPOINT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"git-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/git-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"GIT_BASE_DIR": "<GIT_BASE_DIR>",
"MCP_HTTP_HOST": "<MCP_HTTP_HOST>",
"MCP_HTTP_PORT": "<MCP_HTTP_PORT>",
"MCP_HTTP_ENDPOINT_PATH": "<MCP_HTTP_ENDPOINT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -e GIT_BASE_DIR=<GIT_BASE_DIR> -e MCP_HTTP_HOST=<MCP_HTTP_HOST> -e MCP_HTTP_PORT=<MCP_HTTP_PORT> -e MCP_HTTP_ENDPOINT_PATH=<MCP_HTTP_ENDPOINT_PATH> git-mcp-server npx -y @cyanheads/git-mcp-serverВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о git-mcp-server
Как установить git-mcp-server в Claude Code?
Выполните команду claude mcp add git-mcp-server -- npx -y @cyanheads/git-mcp-server.
Что делает git-mcp-server?
Сервер подключает к модели 28 инструментов Git для управления ветками, стейджинга, коммитов, синхронизации с удалёнными репозиториями и работы с worktree.
Какие среды выполнения и транспорты поддерживает сервер?
Для работы подходит Node.js от 20.0.0 или Bun от 1.2.0. Поддерживаются транспорты stdio и Streamable HTTP с настройкой порта через MCP_HTTP_PORT.
