gitlog-mcp
🔍 gitlog-mcp
Дайте вашему AI-агенту суперспособности в работе с историей git.
gitlog-mcp — это MCP-сервер (Model Context Protocol), который позволяет AI-агентам (Claude Code, Cursor, Windsurf и любому MCP-клиенту) понимать что изменилось в репозитории — автоматически генерировать changelog, анализировать коммиты, определять автора изменений и составлять черновики релизных заметок.
«Что изменилось в этом репозитории?» — вопрос, на который каждый AI-агент отвечает неправильно. Это исправляет ситуацию.
Зачем это нужно
AI-агенты для программирования отлично пишут код, но печально известны тем, что не знают истории кодовой базы. Они выдумывают changelog, ошибочно приписывают авторство и угадывают релизные заметки. gitlog-mcp даёт им надёжное, структурированное окно в git log — чтобы их ответы основывались на том, что действительно произошло, а не на вымысле.
Related MCP server: Git Insight MCP
Возможности
📝 Авто-changelog — создавайте чистый, сгруппированный changelog из любого диапазона тегов/коммитов
🔎 Анализ коммитов — объясняет почему произошло изменение, а не только что изменилось
👤 Определение автора (blame) — кто что изменил и когда (с контекстом)
🏷️ Релизные заметки — черновик релизных заметок на основе различий между тегами
📊 Здоровье репозитория — частота коммитов, топ-контрибьюторы, горячие точки изменений
🧱 Нулевые зависимости времени выполнения — чистый Python stdlib + MCP SDK, один файл
Быстрый старт
# 1. Install from PyPI
pip install gitlog-mcp
# 2. Run standalone (for testing) — defaults to the current directory
gitlog-mcp
gitlog-mcp --repo /path/to/your/repo
# 3. Or add directly to your agent's MCP config (see below)Хотите также локальную веб-панель? Это опциональное дополнение, не устанавливается по умолчанию:
pip install "gitlog-mcp[ui]". Обычныйpip install gitlog-mcpостаётся без зависимостей, как и прежде.
Установка из исходного кода (для контрибьюторов):
git clone https://github.com/ManiaSacha/gitlog-mcp.git && cd gitlog-mcp && pip install -e .— подробнее в CONTRIBUTING.md.
Конфигурация Claude Code
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Конфигурация Cursor (.cursor/mcp.json)
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Конфигурация Windsurf
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Отладка отдельно
Хотите опробовать инструменты напрямую перед подключением к агенту? MCP Inspector предоставляет интерфейс для вызова каждого инструмента вручную:
npx @modelcontextprotocol/inspector gitlog-mcp --repo .Примеры запросов к агенту
«Сгенерируй changelog всего, что изменилось между
v1.2.0иv1.3.0».
«Кто внёс эту ошибочную строку в
src/parser.pyи почему?»
«Составь черновик релизных заметок для следующей версии на основе последних коммитов».
Доступные инструменты
Инструмент | Описание |
| Сгруппированный changelog для диапазона коммитов/тегов |
| Объясняет намерения и влияние конкретного коммита |
| Построчное определение автора для файла |
| Черновик релизных заметок между двумя тегами |
| Сводка по контрибьюторам и изменениям |
| Поиск коммитов по сообщению/автору/дате |
Веб-панель (опционально)
Предпочитаете браузер терминалу? gitlog-mcp-ui предоставляет небольшую локальную панель на основе того же кода для чтения git, что и MCP-инструменты — те же данные, человекочитаемый формат.
pip install "gitlog-mcp[ui]"
gitlog-mcp-ui --repo /path/to/repoКоманда выводит URL (http://127.0.0.1:8765 по умолчанию) — откройте его в браузере; панель не откроет его за вас.
Вид | Что показывает |
Changelog | Выбор диапазона коммитов ( |
Repo Health | Статистика контрибьюторов, общее количество коммитов |
Blame | Построчное определение автора для каждого файла |
Только чтение — никаких действий записи. Построена только для локального использования: привязывается только к 127.0.0.1 (нет флага --host, поэтому её нельзя случайно открыть для сети), а также проверяет заголовок Host каждого запроса, закрывая возможность DNS-ребендинга, которую не покрывает только loopback-привязка. Аутентификация не требуется, потому что до неё может добраться только ваша собственная машина.
Это опциональное дополнение (pip install gitlog-mcp[ui]), не устанавливается по умолчанию. Основной сервер gitlog-mcp не имеет зависимостей времени выполнения, кроме MCP SDK, точка — панель это не меняет. Это http.server из stdlib, никакого фреймворка, никаких дополнительных зависимостей.
Архитектура
gitlog-mcp (single file, ~300 lines)
├── FastMCP server (stdio transport)
├── GitRunner — thin wrapper over `git` CLI
└── Tools — each maps to a git subcommand + parsingНамеренно компактная. Вы можете прочитать всё за полдня — это особенность.
Участие в разработке
PR приветствуются. Только маленькие, целенаправленные, хорошо протестированные изменения. См. CONTRIBUTING.md.
Процесс релиза и версионирование описаны в RELEASING.md.
План развития
Автоопределение
--repoиз текущей директорииСтруктурированный JSON-вывод для всех инструментов
Интеграция с GitHub/GitLab
Тесты + значок CI
Лицензия
MIT © 2026 — создано в открытую, для сообщества открытого кода.
Поставьте звезду этому репозиторию, если хотите, чтобы AI-агенты перестали выдумывать ваш changelog. ⭐
Available Tools
6 toolsanalyze_commitC
Explain a specific commit's intent and impact.
Inputs: sha (required). Returns: result
blame_fileC
Line-level attribution for a file (who, when, which commit).
Inputs: path (required). Returns: result
changelogC
Generate a grouped changelog for a commit range (e.g. v1.2.0..v1.3.0).
Inputs: since, until. Returns: result
release_notesC
Draft release notes between two tags.
Inputs: to_tag (required), from_tag (required). Returns: result
repo_healthB
Contributor + churn summary for the repo.
Inputs: no named parameters. Returns: result
search_commitsC
Find commits by message, author, or date.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes: changelog vs. release_notes share overlap in generating summaries from commit ranges/tags, which could cause confusion. However, the others are clearly separated.
All tool names use a consistent verb_noun pattern (changelog is a noun but functions as a verb, minor deviation). Names are clear and predictable.
6 tools is well-scoped for a Git log/analysis server, covering key operations without bloat.
Covers commit analysis, search, blame, release notes, and health metrics. A possible gap is direct diff retrieval between commits, but core workflows are well-supported.
Maintenance
Related MCP Connectors
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Team memory for AI coding agents and code reviews, reviewed by humans and served over MCP.
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Repo intel for AI coding agents: overview, PRs, contributors, hot files, CI, deps. Remote MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAutomatically extracts architectural decisions, patterns, and insights from Git commits to build a local, structured project memory. It exposes this living context to AI tools via MCP, allowing them to understand the historical reasoning and evolution behind your codebase.53 npm6MIT
- AlicenseAqualityDmaintenanceSemantic git queries via MCP. Beyond git log — answer who/what/why about any line, file, or branch with blame, co-change, PR linkage.613 npm2MIT
- AlicenseNot gradedqualityBmaintenanceLocal-first CLI that mines git history for file-level co-change patterns and builds a queryable knowledge graph for AI coding agents, exposed via an MCP server.5 npmApache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search commits, retrieve diffs, and inspect file change history in a Git repository using MCP.61 npmMIT