git

mcp-git-tools

MCP（Model Context Protocol）経由で提供される、AI エージェント向けの Git リポジトリ分析ツールです。ネイティブの git コマンドを使ってローカルリポジトリを分析します。GitHub API は不要です。

ツール

ツール	説明
git_log	作成者、日付範囲、ファイルパスで絞り込んだコミット履歴を取得します
git_diff	変更の概要とともに、コミット、ブランチ、タグ間の差分を表示します
git_blame	ファイルの各行を最後に変更したユーザーとコミット情報を表示します
git_stats	リポジトリの統計情報：コミット数、コントリビューター、期間ごとのアクティビティ、変更頻度の高いファイル
git_branch	最終コミット情報、先行／遅延数、マージ済み／未マージの状態とともにブランチを一覧表示します

前提条件

• Node.js >= 18
• Git がインストールされ、PATH から利用できること

セットアップ

npm install
npm run build

設定

MCP クライアントの設定に追加します：

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

ツールの詳細

git_log

オプションのフィルターを指定して、最近のコミット履歴を取得します。

パラメーター：

• repoPath（必須）— Git リポジトリの絶対パス
• count — 返すコミット数（デフォルト：20）
• author — 作成者名またはメールアドレスで絞り込みます
• since / until — 日付範囲のフィルター
• path — 特定のファイルまたはディレクトリに関係するコミットに絞り込みます

git_diff

2 つの参照を比較し、変更の構造化された概要を取得します。

パラメーター：

• repoPath（必須）— Git リポジトリの絶対パス
• from — 開始参照（デフォルト：HEAD~1）
• to — 終了参照（デフォルト：HEAD）
• path — 特定のファイルまたはディレクトリに差分を限定します
• summaryOnly — 差分の全文を含めず、統計情報のみを返します

git_blame

ファイルの各行の作成者を確認します。

パラメーター：

• repoPath（必須）— Git リポジトリの絶対パス
• filePath（必須）— リポジトリのルートからの相対ファイルパス
• startLine / endLine — 特定の行範囲を対象に blame を実行します
• ref — 特定のコミット時点で blame を実行します

git_stats

リポジトリのアクティビティの概要を取得します。

パラメーター：

• repoPath（必須）— Git リポジトリの絶対パス
• topAuthors — 上位コントリビューターの表示数（デフォルト：10）
• topFiles — 変更頻度の高いファイルの表示数（デフォルト：10）

git_branch

ブランチを一覧表示して分析します。

パラメーター：

• repoPath（必須）— Git リポジトリの絶対パス
• baseBranch — 比較対象のブランチ（デフォルト：main または master）
• includeRemote — リモート追跡ブランチを含めます
• mergedOnly / unmergedOnly — マージ状態で絞り込みます

ライセンス

MIT