🔍 gitlog-mcp

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

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

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

なぜこれが存在するのか

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

Related MCP server: Continuum

機能

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

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

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

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

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

• 🧱 ゼロランタイム依存関係 — 純粋な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のこのバグの原因となった行を誰が導入し、なぜですか？」

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

公開ツール

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）が出力されます — ブラウザで開いてください。自動的には開きません。

読み取り専用 — 書き込みアクションはどこにもありません。設計上ローカル専用：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エージェントがあなたのチェンジログを幻覚しなくなるように。⭐