Skip to main content
Glama
gitlog-mcp
by ManiaSacha

🔍 gitlog-mcp

AIコーディングエージェントにgit履歴のスーパーパワーを与えます。

gitlog-mcpは、Model Context Protocol(MCP)サーバーであり、AIエージェント(Claude Code、Cursor、Windsurf、および任意のMCPクライアント)がリポジトリの変更内容を理解できるようにします — 自動チェンジログ生成、コミット分析、属性の特定、リリースノートの草案作成を実現します。

「このリポジトリで何が変わったのか?」という質問は、どのAIエージェントも間違えます。これを修正します。

PyPI CI GitHub stars Python License Zero deps


なぜこれが存在するのか

AIコーディングエージェントはコードを書くのは得意ですが、コードベースの履歴を知るのは有名なほど苦手です。チェンジログを幻覚し、属性を誤認し、リリースノートを推測します。gitlog-mcpは、git logへの信頼できる構造化された窓を提供し、エージェントの回答が実際に起こったことに基づき、創作ではないことを保証します。

Related MCP server: Git Insight MCP

機能

  • 📝 自動チェンジログ — 任意のタグ/コミット範囲からクリーンでグループ化されたチェンジログを生成

  • 🔎 コミット分析 — 変更内容だけでなく、なぜ変更が起こったのかを説明

  • 👤 属性の特定 — 誰が、いつ、何に触れたか(コンテキスト付き)

  • 🏷️ リリースノート — タグ間の差分からリリースノートを草案

  • 📊 リポジトリ健全性 — コミット頻度、トップコントリビューター、チャーンが多いホットスポット

  • 🧱 ゼロランタイム依存関係 — 純粋なPython標準ライブラリ + 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)

ローカルWebダッシュボードもお求めですか?オプションの追加機能で、デフォルトではインストールされません: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を使用すると、各ツールを手動で呼び出すUIが表示されます:

npx @modelcontextprotocol/inspector gitlog-mcp --repo .

エージェントプロンプトの例

「v1.2.0とv1.3.0の間で変更されたすべてのもののチェンジログを生成してください。」

「src/parser.pyのこのバグの原因となった行を誰が導入し、なぜですか?」

「最近のコミットに基づいて、次のバージョンのリリースノートを草案してください。」

公開ツール

ツール

説明

changelog

コミット/タグ範囲のグループ化されたチェンジログ

analyze_commit

特定のコミットの意図と影響を説明

blame_file

ファイルの行レベルの属性

release_notes

2つのタグ間のリリースノートを草案

repo_health

コントリビューター + チャーンの概要

search_commits

メッセージ/作成者/日付でコミットを検索

Webダッシュボード(オプション)

ターミナルよりもブラウザがお好みですか?gitlog-mcp-uiは、MCPツールが使用する同じgit読み取りコードの上に、小さなローカルダッシュボードを提供します — 同じデータを人間が読める形で表示します。

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

これによりURL(デフォルトではhttp://127.0.0.1:8765)が出力されます — ブラウザで開いてください。自動的には開きません。

表示

表示内容

チェンジログ

コミット範囲ピッカー(since / until)

リポジトリ健全性

コントリビューター統計、コミット合計

属性

ファイルごと、行ごとの属性

読み取り専用 — 書き込みアクションはどこにもありません。設計上ローカル専用:127.0.0.1のみにバインド(--hostフラグはないため、偶発的にネットワークに公開されることはありません)。さらに、すべてのリクエストのHostヘッダーも検証し、ループバックバインディングだけではカバーできないDNSリバインディングギャップを閉じます。認証は不要です。自分のマシン以外からは到達できないからです。

これはオプションの追加機能(pip install gitlog-mcp[ui])であり、デフォルトではインストールされません。コアのgitlog-mcpサーバーは、MCP SDK以外のランタイム依存関係は完全にゼロです — ダッシュボードはそれを変えません。http.server(標準ライブラリ)を使用しており、フレームワークも独自の追加依存関係もありません。

アーキテクチャ

gitlog-mcp (single file, ~300 lines)
├── FastMCP server (stdio transport)
├── GitRunner — thin wrapper over `git` CLI
└── Tools — each maps to a git subcommand + parsing

意図的に小さくしています。半日で全部読めます — それが特徴です。

コントリビューション

プルリクエスト歓迎。小さく、焦点を絞り、十分にテストされた変更のみ。詳細はCONTRIBUTING.mdを参照してください。

リリースプロセスとバージョニングはRELEASING.mdに文書化されています。

ロードマップ

  • --repo カレントディレクトリからの自動検出

  • すべてのツールに対する構造化JSON出力

  • GitHub/GitLabリモート統合

  • テスト + CIバッジ

ライセンス

MIT © 2026 — オープンソースコミュニティのために、公開で構築されています。


このリポジトリにスターを付けてください、AIエージェントがあなたのチェンジログを幻覚しなくなるように。⭐

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