gitlog-mcp
🔍 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: 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のこのバグの原因となった行を誰が導入し、なぜですか?」
「最近のコミットに基づいて、次のバージョンのリリースノートを草案してください。」
公開ツール
ツール | 説明 |
| コミット/タグ範囲のグループ化されたチェンジログ |
| 特定のコミットの意図と影響を説明 |
| ファイルの行レベルの属性 |
| 2つのタグ間のリリースノートを草案 |
| コントリビューター + チャーンの概要 |
| メッセージ/作成者/日付でコミットを検索 |
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エージェントがあなたのチェンジログを幻覚しなくなるように。⭐
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