MCP Git

🚀 mcp-server-git: Git用MCPサーバー

Gitリポジトリの相互作用と自動化のためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーは、大規模言語モデルを介してGitリポジトリの読み取り、検索、操作を行うツールを提供します。

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

✨ 主な機能

ツール

1. git_status

   • 作業ツリーの状態を表示します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
   • 戻り値: 作業ディレクトリの現在の状態をテキスト出力として返します。

2. git_diff_unstaged

   • 作業ディレクトリ内のまだステージングされていない変更を表示します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
   • 戻り値: ステージングされていない変更の差分出力を返します。

3. git_diff_staged

   • コミットのためにステージングされた変更を表示します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
   • 戻り値: ステージングされた変更の差分出力を返します。

4. git_diff

   • ブランチまたはコミット間の差分を表示します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
     • target (文字列): 比較するターゲットブランチまたはコミット
   • 戻り値: 現在の状態とターゲットとの差分出力を返します。

5. git_commit

   • リポジトリへの変更を記録します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
     • message (文字列): コミットメッセージ
   • 戻り値: 新しいコミットハッシュを含む確認メッセージを返します。

6. git_add

   • ファイルの内容をステージングエリアに追加します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
     • files (文字列配列): ステージングするファイルパスの配列
   • 戻り値: ステージングされたファイルの確認メッセージを返します。

7. git_reset

   • すべてのステージングされた変更をアンステージングします。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
   • 戻り値: リセット操作の確認メッセージを返します。

8. git_log

   • コミットログを表示します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
     • max_count (数値、オプション): 表示する最大コミット数（デフォルト: 10）
   • 戻り値: ハッシュ、作者、日付、メッセージを含むコミットエントリの配列を返します。

9. git_create_branch

   • 新しいブランチを作成します。
   • 入力:
     • repo_path (文字列): Gitリポジトリのパス
     • branch_name (文字列): 新しいブランチの名前
     • start_point (文字列、オプション): 新しいブランチの開始ポイント
   • 戻り値: ブランチ作成の確認メッセージを返します。

10. git_checkout

    • ブランチを切り替えます。
    • 入力:
      • repo_path (文字列): Gitリポジトリのパス
      • branch_name (文字列): 切り替えるブランチの名前
    • 戻り値: ブランチ切り替えの確認メッセージを返します。

11. git_show

    • コミットの内容を表示します。
    • 入力:
      • repo_path (文字列): Gitリポジトリのパス
      • revision (文字列): 表示するリビジョン（コミットハッシュ、ブランチ名、タグ）
    • 戻り値: 指定されたコミットの内容を返します。

12. git_init

    • Gitリポジトリを初期化します。
    • 入力:
      • repo_path (文字列): Gitリポジトリを初期化するディレクトリのパス
    • 戻り値: リポジトリ初期化の確認メッセージを返します。

📦 インストール

uvを使用する場合（推奨）

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

PIPを使用する場合

代わりに、mcp-server-git をpipを介してインストールすることができます。

pip install mcp-server-git

インストール後、以下のコマンドを使用してスクリプトとして実行できます。

python -m mcp_server_git

📚 ドキュメント

環境変数

サーバーは、.env ファイルから環境変数をロードすることをサポートしており、以下の優先順位で読み込まれます。

1. プロジェクト固有の.envファイル - 現在の作業ディレクトリ内の .env ファイル
2. リポジトリ固有の.envファイル - リポジトリディレクトリ内の .env ファイル（--repository 引数を使用する場合）
3. ClaudeCode作業ディレクトリの.envファイル - ClaudeCodeワークスペースルート内の .env ファイル（自動検出）
4. システム環境変数 - 標準の環境変数

.envファイルの例

プロジェクトディレクトリまたはClaudeCodeワークスペースに .env ファイルを作成します。

# GitHub API Token for GitHub integration features
# Get your token from: https://github.com/settings/tokens
GITHUB_TOKEN=your_github_token_here

# Optional: Custom GitHub API base URL (for GitHub Enterprise)
# GITHUB_API_BASE_URL=https://api.github.com

# Optional: Log level for debugging
# LOG_LEVEL=INFO

注意: サーバー起動時に .env ファイルは自動的に読み込まれます。サーバーは、現在の作業ディレクトリとリポジトリパス（--repository 引数で指定された場合）の両方から上方向にトラバースすることで、ClaudeCodeワークスペースディレクトリを自動的に検出します。.env ファイルが見つからない場合、サーバーはシステム環境変数を使用します。

ClaudeCodeユーザー向け: ClaudeCodeワークスペースルート（例: /home/memento/ClaudeCode/.env）に .env ファイルがある場合、そのワークスペース内の任意のサブディレクトリからMCPサーバーを実行すると、自動的に検出されて読み込まれます。

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での使用方法

すぐにインストールするには、以下のワンクリックインストールボタンを使用してください。

手動でインストールするには、VS Codeのユーザー設定（JSON）ファイルに以下のJSONブロックを追加します。これは、Ctrl + Shift + P を押して Preferences: Open Settings (JSON) と入力することで行えます。

オプションで、ワークスペース内の .vscode/mcp.json ファイルに追加することもできます。これにより、他の人と設定を共有できます。

注: .vscode/mcp.json ファイルでは mcp キーは必要ありません。

{
  "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"]
    }
  }
},

🔧 デバッグ

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 を実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。

開発

ローカル開発を行っている場合、変更をテストする方法は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ライセンスの下で提供されています。これは、MITライセンスの条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。