Git

mcp-server-git：Git MCP サーバー

概要

Git リポジトリとのやり取りと自動化を行うための Model Context Protocol サーバーです。このサーバーは、LLM を介して Git リポジトリの読み取り、検索、操作を行うツールを提供します。

ソース：https://github.com/modelcontextprotocol/servers/tree/main/src/git

MCP Python SDK 2.x（mcp>=2.3,<3）が必要です。このサーバーは SDK の高水準な MCPServer を基盤として構築されています。各ツールは型付きの Python 関数で、SDK が関数シグネチャから入力スキーマを生成します。

mcp-server-git は現在、初期開発段階です。サーバーの開発と改善を続ける中で、機能や利用可能なツールは変更、拡張される場合があります。

ツール

1. git_status

   • 作業ツリーの状態を表示します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
   • 戻り値：作業ディレクトリの現在の状態をテキストで出力します

2. git_diff_unstaged

   • まだステージングされていない作業ディレクトリの変更を表示します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • context_lines（number、任意）：表示するコンテキスト行数（デフォルト：3）
   • 戻り値：ステージングされていない変更の差分出力

3. git_diff_staged

   • コミット用にステージングされた変更を表示します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • context_lines（number、任意）：表示するコンテキスト行数（デフォルト：3）
   • 戻り値：ステージングされた変更の差分出力

4. git_diff

   • ブランチまたはコミット間の差分を表示します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • target（string）：比較対象のブランチまたはコミット
     • context_lines（number、任意）：表示するコンテキスト行数（デフォルト：3）
   • 戻り値：現在の状態と比較対象との差分出力

5. git_commit

   • リポジトリに変更を記録します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • message（string）：コミットメッセージ
   • 戻り値：新しいコミットハッシュを含む確認メッセージ。ステージングされた変更がない場合は、--allow-empty を指定しない git commit と同様にエラーになります。ただし、マージ進行中（MERGE_HEAD が存在する場合）は例外で、Git は空のコミットも許可します。マージ進行中にコミットするとマージが完了します。そのコミットは HEAD とすべての MERGE_HEAD コミットを親に持ち、マージ状態は解除されます

6. git_add

   • ファイルの内容をステージングエリアに追加します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • files（string[]）：ステージングするファイルパスの空でない配列。["."] を指定するとすべてのファイルがステージングされます
   • 戻り値：ステージングされたファイルの確認メッセージ。呼び出し後もインデックスに変更がない場合は、何もステージングされなかったことを示すメッセージ

7. git_reset

   • ステージングされた変更をすべてステージング解除します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
   • 戻り値：リセット操作の確認メッセージ

8. git_log

   • 日付による絞り込みを指定して、コミットログを表示します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • max_count（number、任意）：表示するコミットの最大数（デフォルト：10）
     • start_timestamp（string、任意）：コミットを絞り込む開始タイムスタンプ。ISO 8601 形式（例：'2024-01-15T14:30:25'）、相対日付（例：'2 weeks ago'、'yesterday'）、または絶対日付（例：'2024-01-15'、'Jan 15 2024'）を指定できます
     • end_timestamp（string、任意）：コミットを絞り込む終了タイムスタンプ。ISO 8601 形式（例：'2024-01-15T14:30:25'）、相対日付（例：'2 weeks ago'、'yesterday'）、または絶対日付（例：'2024-01-15'、'Jan 15 2024'）を指定できます
   • 戻り値：ハッシュ、作成者、日付、メッセージを含むコミットエントリーの配列

9. git_create_branch

   • 新しいブランチを作成します
   • 入力：
     • repo_path（string）：Git リポジトリへのパス
     • branch_name（string）：新しいブランチの名前
     • base_branch（string、任意）：作成元のブランチ（デフォルトは現在のブランチ）
   • 戻り値：ブランチ作成の確認

10. git_checkout

• ブランチを切り替えます
• 入力：
  • repo_path（string）：Git リポジトリへのパス
  • branch_name（string）：チェックアウトするブランチの名前
• 戻り値：ブランチ切り替えの確認。branch_name がブランチではない場合（sha、タグ、その他のリビジョン）は、HEAD is now detached at <short sha>

11. git_show

• コミットの内容、または指定したリビジョンにおけるファイルやディレクトリの内容を表示します
• 入力：
  • repo_path（string）：Git リポジトリへのパス
  • revision（string）：表示するリビジョン（コミットハッシュ、ブランチ名、タグ）またはオブジェクト指定（HEAD:path/to/file）
• 戻り値：指定したコミットの内容、ファイルの内容、またはディレクトリ一覧

12. git_branch

• Git ブランチを一覧表示します
• 入力：
  • repo_path（string）：Git リポジトリへのパス。
  • branch_type（string）：ローカルブランチ（'local'）、リモートブランチ（'remote'）、またはすべてのブランチ（'all'）のいずれを一覧表示するか。
  • contains（string、任意）：ブランチに含まれている必要があるコミット sha。コミット sha が指定されていない場合、このパラメーターには何も渡さないでください
  • not_contains（string、任意）：ブランチに含まれていてはならないコミット sha。コミット sha が指定されていない場合、このパラメーターには何も渡さないでください
• 戻り値：ブランチの一覧

プロトコルのバージョン

このサーバーは、標準入出力を介してModel Context Protocolの両方の世代に対応しており、設定は不要です。2026-07-28 クライアント（server/discover で検出され、セッションなし）と、2025-11-25 クライアント（initialize ハンドシェイク）に対応しています。クライアントの最初のリクエストによって、どちらを使用するかが決まります。ツールはどちらの世代でも同じように動作します。

Rootsは2026-07-28で非推奨となっており、このサーバーはどちらの世代でもクライアントにRootsを要求しません。リポジトリへのアクセスには、--repositoryのみを使用するか、--repositoryが指定されていない場合は各ツール呼び出しのrepo_pathを使用します。pingなど、2026-07-28の仕様で削除されたメソッドに応答するのは、2025-11-25の接続のみです。

エラー

• 失敗したツールは、テキストがError executing tool <name>: <message>のisError: trueを含む結果を返すため、モデルはエラーを読み取り、呼び出しを修正できます。これには、Gitのエラー（不明なリビジョン、コマンドの失敗）、リポジトリではない、または--repositoryの外部にあるrepo_path、フラグインジェクション対策、およびツールの入力スキーマに一致しない引数が含まれます。
• 不明なツール名は、仕様で両方の世代に求められているとおり、プロトコルエラーのJSON-RPC -32602（Unknown tool: <name>）になります。2.0.0より前のバージョンでは、isErrorの結果でした。

インストール

uvを使用する（推奨）

uvを使用する場合、特別なインストールは不要です。uvxを使用して、mcp-server-gitを直接実行します。

PIPを使用する

または、pipを使用してmcp-server-gitをインストールできます。

pip install mcp-server-git

インストール後、スクリプトとして次のように実行できます。

python -m mcp_server_git

設定

--repository（-r）には、Gitワーキングツリー内の任意のパスを指定できます。起動時、サーバーはgit rev-parse --show-toplevelと同様に、親ディレクトリをたどってリポジトリのルートを特定します。そのため、共有設定をリポジトリ内の任意のサブディレクトリから起動する場合も、--repository .を使用できます。リポジトリ内のパスを指定すれば、指定したサブディレクトリの配下だけでなく、そのリポジトリ内のどこからでもツールを呼び出せます。存在しないパス、またはGitリポジトリ内にないパスは、起動時に1行のエラーとしてログに記録されます。

Claude Desktop での使用方法

これを claude_desktop_config.json に追加します。

"mcpServers": {
  "git": {
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
  }
}

"mcpServers": {
  "git": {
    "command": "docker",
    "args": ["run", "--rm", "-i", "--mount", "type=bind,src=/Users/username,dst=/Users/username", "mcp/git"]
  }
}

"mcpServers": {
  "git": {
    "command": "python",
    "args": ["-m", "mcp_server_git", "--repository", "path/to/git/repo"]
  }
}

VS Code での使用方法

すばやくインストールするには、以下のワンクリックインストールボタンのいずれかを使用してください……

手動でインストールする場合は、次のいずれかの方法で MCP サーバーを設定できます。

方法 1：ユーザー設定（推奨） ユーザーレベルの MCP 設定ファイルに設定を追加します。コマンドパレット（Ctrl + Shift + P）を開き、MCP: Open User Configuration を実行します。ユーザーの mcp.json ファイルが開くので、そこにサーバー設定を追加できます。

方法 2：ワークスペース設定 代わりに、ワークスペース内の .vscode/mcp.json というファイルに設定を追加できます。これにより、設定を他のユーザーと共有できます。

VS Code での MCP 設定の詳細については、VS Code の公式 MCP ドキュメントをご覧ください。

{
  "servers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git"]
    }
  }
}

Docker でインストールする場合：

{
  "mcp": {
    "servers": {
      "git": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "--mount", "type=bind,src=${workspaceFolder},dst=/workspace",
          "mcp/git"
        ]
      }
    }
  }
}

Zed での使用方法

Zed の settings.json に追加します。

"context_servers": [
  "mcp-server-git": {
    "command": {
      "path": "uvx",
      "args": ["mcp-server-git"]
    }
  }
],

"context_servers": {
  "mcp-server-git": {
    "command": {
      "path": "python",
      "args": ["-m", "mcp_server_git"]
    }
  }
},

Zencoder での使用方法

1. Zencoder メニュー（...）を開きます。
2. ドロップダウンメニューから Agent Tools を選択します。
3. Add Custom MCP をクリックします。
4. 名前（例：git）と以下のサーバー設定を追加し、必ず Install ボタンをクリックしてください。

{
    "command": "uvx",
    "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
}

デバッグ

MCP インスペクターを使用して、サーバーをデバッグできます。uvx でインストールした場合：

npx @modelcontextprotocol/inspector uvx mcp-server-git

特定のディレクトリにパッケージをインストールした場合、またはパッケージを開発している場合：

cd path/to/servers/src/git
npx @modelcontextprotocol/inspector uv run mcp-server-git

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log を実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。

開発

テストとカバレッジ

テストスイートは、MCP の ClientSession を介してプロセス内で serve() を実行します（tests/conftest.py を参照）。また、tests/test_eras.py は Client を 2026-07-28 クライアントおよび 2025-11-25 クライアントとして実行します。src/git から次を実行します。

uv run --frozen pytest                 # the tests
uv run --frozen pytest --cov --cov-report=term-missing --cov-report=json

2つ目のコマンドでは、src/mcp_server_git のブランチカバレッジも計測し、ファイルごとに表示するとともに coverage.json に書き込みます（git の対象外です）。すべてのファイルで、行カバレッジとブランチカバレッジをそれぞれ 90% 以上に保つ必要があります。到達できないコードには、この基準を下げる代わりに # pragma: no cover # <reason> を付けます。

クライアントで変更を試す

クライアントで変更を試す方法は2つあります。

1. MCP インスペクターを実行して変更をテストします。実行方法についてはデバッグを参照してください。

2. Claude デスクトップアプリを使ってテストします。次の内容を claude_desktop_config.json に追加します。

Docker

{
  "mcpServers": {
    "git": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--mount", "type=bind,src=/Users/username/Desktop,dst=/projects/Desktop",
        "--mount", "type=bind,src=/path/to/other/allowed/dir,dst=/projects/other/allowed/dir,ro",
        "--mount", "type=bind,src=/path/to/file.txt,dst=/projects/path/to/file.txt",
        "mcp/git"
      ]
    }
  }
}

UVX

{
"mcpServers": {
  "git": {
    "command": "uv",
    "args": [
      "--directory",
      "/<path to mcp-servers>/mcp-servers/src/git",
      "run",
      "mcp-server-git"
    ]
    }
  }
}

ビルド

Docker のビルド：

cd src/git
docker build -t mcp/git .

ライセンス

この MCP サーバーは MIT License のもとでライセンスされています。これは、MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。