Skip to main content
Glama
gitlog-mcp
by ManiaSacha

🔍 gitlog-mcp

Дайте вашему AI-агенту суперспособности в работе с историей git.

gitlog-mcp — это MCP-сервер (Model Context Protocol), который позволяет AI-агентам (Claude Code, Cursor, Windsurf и любому MCP-клиенту) понимать что изменилось в репозитории — автоматически генерировать changelog, анализировать коммиты, определять автора изменений и составлять черновики релизных заметок.

«Что изменилось в этом репозитории?» — вопрос, на который каждый AI-агент отвечает неправильно. Это исправляет ситуацию.

PyPI CI GitHub stars Python License Zero deps


Зачем это нужно

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

Сгруппированный changelog для диапазона коммитов/тегов

analyze_commit

Объясняет намерения и влияние конкретного коммита

blame_file

Построчное определение автора для файла

release_notes

Черновик релизных заметок между двумя тегами

repo_health

Сводка по контрибьюторам и изменениям

search_commits

Поиск коммитов по сообщению/автору/дате

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

Предпочитаете браузер терминалу? 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

Выбор диапазона коммитов (since / until)

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 tools
analyze_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

    B3.1/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    6 tools is well-scoped for a Git log/analysis server, covering key operations without bloat.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Automatically 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 npm
      6
      MIT