🔍 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: Continuum

Возможности

• 📝 Авто-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 и почему?»

«Составь черновик релизных заметок для следующей версии на основе последних коммитов».

Доступные инструменты

Веб-панель (опционально)

Предпочитаете браузер терминалу? gitlog-mcp-ui предоставляет небольшую локальную панель на основе того же кода для чтения git, что и MCP-инструменты — те же данные, человекочитаемый формат.

pip install "gitlog-mcp[ui]"
gitlog-mcp-ui --repo /path/to/repo

Команда выводит URL (http://127.0.0.1:8765 по умолчанию) — откройте его в браузере; панель не откроет его за вас.

Только чтение — никаких действий записи. Построена только для локального использования: привязывается только к 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. ⭐