mcp-server-git: Git MCP サーバー
概要
Gitリポジトリのインタラクションと自動化のためのモデルコンテキストプロトコルサーバー。このサーバーは、大規模言語モデルを介してGitリポジトリの読み取り、検索、操作を行うツールを提供します。
mcp-server-gitは現在開発初期段階にあります。サーバーの開発と改良に伴い、機能と利用可能なツールは変更・拡張される可能性があります。
ツール
git_status作業ツリーのステータスを表示します
入力:
repo_path(文字列): Gitリポジトリへのパス
戻り値: 作業ディレクトリの現在の状態をテキスト出力として返す
git_diff_unstaged作業ディレクトリ内のまだステージングされていない変更を表示します
入力:
repo_path(文字列): Gitリポジトリへのパス
戻り値: ステージングされていない変更の差分出力
git_diff_stagedコミットのためにステージングされた変更を表示します
入力:
repo_path(文字列): Gitリポジトリへのパス
戻り値: ステージングされた変更の差分出力
git_diffブランチまたはコミット間の差異を表示します
入力:
repo_path(文字列): Gitリポジトリへのパスtarget(文字列): 比較する対象のブランチまたはコミット
戻り値: 現在の状態とターゲットを比較した差分出力
git_commitリポジトリへの変更を記録する
入力:
repo_path(文字列): Gitリポジトリへのパスmessage(文字列): コミットメッセージ
戻り値: 新しいコミットハッシュによる確認
git_addファイルの内容をステージング領域に追加します
入力:
repo_path(文字列): Gitリポジトリへのパスfiles(文字列[]): ステージングするファイルパスの配列
戻り値: ステージングされたファイルの確認
git_resetステージングされたすべての変更をステージ解除します
入力:
repo_path(文字列): Gitリポジトリへのパス
戻り値: リセット操作の確認
git_logコミットログを表示します
入力:
repo_path(文字列): Gitリポジトリへのパスmax_count(数値、オプション): 表示するコミットの最大数 (デフォルト: 10)
戻り値: ハッシュ、作成者、日付、メッセージを含むコミットエントリの配列
git_create_branch新しいブランチを作成します
入力:
repo_path(文字列): Gitリポジトリへのパスbranch_name(文字列): 新しいブランチの名前start_point(文字列、オプション): 新しいブランチの開始点
戻り値: ブランチ作成の確認
git_checkout
スイッチブランチ
入力:
repo_path(文字列): Gitリポジトリへのパスbranch_name(文字列): チェックアウトするブランチの名前
戻り値: ブランチ切り替えの確認
git_show
コミットの内容を表示します
入力:
repo_path(文字列): Gitリポジトリへのパスrevision(文字列):表示するリビジョン(コミットハッシュ、ブランチ名、タグ)
戻り値: 指定されたコミットの内容
git_init
Gitリポジトリを初期化する
入力:
repo_path(文字列): gitリポジトリを初期化するディレクトリへのパス
戻り値: リポジトリの初期化の確認
Related MCP server: GitLab MCP Server
インストール
uvの使用(推奨)
uvを使用する場合、特別なインストールは必要ありません。uvx uvx使用してmcp-server-gitを直接実行します。
PIPの使用
あるいは、pip 経由でmcp-server-gitをインストールすることもできます。
pip install mcp-server-gitインストール後、次のコマンドを使用してスクリプトとして実行できます。
python -m mcp_server_git構成
Claude Desktopでの使用
これをclaude_desktop_config.jsonに追加します:
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "path/to/git/repo"]
}
}注: '/Users/username' を、このツールでアクセスできるようにするパスに置き換えてください。
"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 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-gittail -n 20 -f ~/Library/Logs/Claude/mcp*.logを実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。
発達
ローカル開発を行っている場合、変更をテストする方法は 2 つあります。
MCPインスペクタを実行して変更内容をテストしてください。実行手順についてはデバッグを参照してください。
Claudeデスクトップアプリを使ってテストし
claude_desktop_config.json。claude_desktop_config.json に以下のコードを追加してください。
ドッカー
{
"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ファイルをご覧ください。