Wiki: ページの作成:「== 概要 == Git MCP Server (mcp-server-git) は、Anthropicが開発したModel Context Protocol (MCP) の公式リファレンス実装の1つであり、
AIアシスタントがGitリポジトリと対話するための標準化されたインターフェースを提供するサーバである。

Python (uv) で実装されており、`uvx` コマンドを使用してインストール不要で直接実行できる。
Claude Desktop、…」

2026-03-25T08:38:21Z

ページの作成:「== 概要 == Git MCP Server (mcp-server-git) は、Anthropicが開発したModel Context Protocol (MCP) の公式リファレンス実装の1つであり、 AIアシスタントがGitリポジトリと対話するための標準化されたインターフェースを提供するサーバである。 Python (uv) で実装されており、<code>uvx</code> コマンドを使用してインストール不要で直接実行できる。 Claude Desktop、…」

新規ページ

== 概要 ==
Git MCP Server (mcp-server-git) は、Anthropicが開発したModel Context Protocol (MCP) の公式リファレンス実装の1つであり、 
AIアシスタントがGitリポジトリと対話するための標準化されたインターフェースを提供するサーバである。 
 
Python (uv) で実装されており、<code>uvx</code> コマンドを使用してインストール不要で直接実行できる。 
Claude Desktop、Claude Code、VS Code、Cursor、Zed等の主要なMCPクライアントに対応している。 
 
Windows、MacOS、Linuxの主要なOSに対応する。 
 
このサーバを使用することにより、AIアシスタントが自然言語による指示でGitリポジトリの状態確認、差分表示、コミット履歴の確認、 
ファイルのステージング・コミット、ブランチの作成・切り替え等の操作を自動化できるようになる。 
 
提供されるツールは以下の4カテゴリ、合計12個である。 
 
<center>
{| class="wikitable"
|+ Gitツール一覧
|-
| ツール名 || 説明
|-
| リポジトリ状態確認ツール || ワーキングツリーの状態確認と差分表示 (git_status、git_diff_unstaged、git_diff_staged、git_diff)
|-
| コミット履歴・検査ツール || コミット履歴の表示と特定コミットの詳細確認 (git_log、git_show)
|-
| ファイル・コミット管理ツール || ファイルのステージング、コミット、リセット (git_add、git_commit、git_reset)
|-
| ブランチ操作ツール || ブランチの一覧表示、作成、切り替え (git_branch、git_create_branch、git_checkout)
|}
</center>
 

== 動作要件 ==
==== 前提条件 ====
Git MCP Serverを使用するために必要な前提条件を以下に示す。 
 
* Python 3.10以降
*: MCPサーバの実行環境として必要
* uv (Astralが提供するPythonパッケージマネージャ)
*: <code>uvx</code> コマンドを使用してMCPサーバを実行するために必要
* Git
*: Gitリポジトリへのアクセスに必要
*: 事前にインストールされていること
 

== インストール ==
==== uvのインストール ====
MCPサーバの実行に必要なuvをインストールする。 
 
===== Windowsの場合 =====
PowerShellを使用する場合は、以下に示すコマンドを実行する。 
 
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 
WinGetを使用する場合は、以下に示すコマンドを実行する。 
 
winget install --id=astral-sh.uv -e
 
===== MacOSの場合 =====
Homebrewを使用する場合は、以下に示すコマンドを実行する。 
 
brew install uv
 
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
===== Linuxの場合 =====
curlを使用する場合は、以下に示すコマンドを実行する。 
 
curl -LsSf https://astral.sh/uv/install.sh | sh
 
wgetを使用する場合は、以下に示すコマンドを実行する。 
 
wget -qO- https://astral.sh/uv/install.sh | sh
 
===== pip経由 (全てのOSで対応) =====
pipを使用してインストールする場合は、以下に示すコマンドを実行する。 
 
pip install uv
 
==== Pythonのインストール ====
<code>uv</code> コマンドを使用してPython 3.10以降をインストールする。 
 
uv python install 3.10
 
==== mcp-server-gitのインストール ====
<code>uvx</code> コマンドを実行する場合は、インストール不要で直接実行できる。(推奨) 
以下に示すコマンドを実行して、Git MCP Serverを起動する。 
 
uvx mcp-server-git --repository /path/to/repo
 
<code>pip</code> コマンドを実行してインストールする場合は、以下に示すコマンドを実行する。 
 
pip install mcp-server-git
 
インストール後は、以下のコマンドで起動する。 
 
python -m mcp_server_git
 
===== コマンドラインオプション =====
下表に、Git MCP Serverが受け付けるコマンドラインオプションを示す。 
 
<center>
{| class="wikitable"
|+ コマンドラインオプション一覧
! オプション !! 説明
|-
| <code>--repository</code> || 対象Gitリポジトリのパスを指定する。(省略時はカレントディレクトリを使用する)
|}
</center>
 

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。 
 
Claude Desktopの設定ファイルを以下に示す。 
* Linux
*: ~/.config/Claude/claude_desktop_config.json
* MacOS
*: ~/Library/Application Support/Claude/claude_desktop_config.json
* Windows
*: %APPDATA%\Claude\claude_desktop_config.json
 
Claude Codeの設定ファイルを以下に示す。 
* ローカルスコープ
*: .mcp.json (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: ~/.claude.json (ホームディレクトリ)
 
VS Codeの設定ファイルを以下に示す。 
* .vscode/mcp.json (プロジェクトルート)
 
Cursorの設定ファイルを以下に示す。 
* グローバル設定
*: ~/.cursor/mcp.json
* プロジェクト設定
*: .cursor/mcp.json
 
==== Claude Desktopの設定 ====
claude_desktop_config.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。 
 
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを使用してGit MCP Serverを追加できる。 
 
以に示すコマンドでMCPサーバをClaude Codeに登録する。 
 
claude mcp add git -- uvx mcp-server-git --repository /path/to/repo
 
プロジェクトスコープで設定する場合は、<code>--scope project</code> オプションを追加する。 
設定は、.mcp.json ファイルに保存される。 
 
claude mcp add --scope project git -- uvx mcp-server-git --repository /path/to/repo
 
上記コマンドにより生成される .mcp.json の内容を以下に示す。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 
==== VS Code / Cursorの設定 ====
.vscode/mcp.json または .cursor/mcp.json ファイルに以下に示す内容を設定する。 
 
<syntaxhighlight lang="json">
{
"mcpServers": {
"git": {
"command": "uvx",
"args": ["mcp-server-git", "--repository", "/path/to/repo"]
}
}
}
</syntaxhighlight>
 

== 提供ツールの一覧 ==
Git MCP Serverは、Gitリポジトリを操作するための12個のツールを4カテゴリに分けて提供する。 
 
==== リポジトリ状態確認ツール ====
下表に、ワーキングツリーの状態確認および差分表示に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ リポジトリ状態確認ツールの一覧
! ツール !! 説明
|-
| <code>git_status</code> || ワーキングツリーの状態を表示する。(変更ファイル、未追跡ファイル等)
|-
| <code>git_diff_unstaged</code> || ステージング前の変更内容を差分表示する。
|-
| <code>git_diff_staged</code> || ステージング済みの変更内容を差分表示する。
|-
| <code>git_diff</code> || ブランチ間またはコミット間の差分を表示する。
|}
</center>
 
==== コミット履歴・検査ツール ====
下表に、コミット履歴の表示と特定コミットの詳細確認に関するツールを示す。 
 
<center>
{| class="wikitable"
|+ コミット履歴・検査ツールの一覧
! ツール !! 説明
|-
| <code>git_log</code> || コミット履歴を表示する。 日付範囲フィルタリング対応。ISO 8601形式または相対日付で指定可能
|-
| <code>git_show</code> || 特定のコミットの詳細内容を表示する。 コミットハッシュ、ブランチ名、タグ等で指定可能
|}
</center>
 
==== ファイル・コミット管理ツール ====
下表に、ファイルのステージング、コミット、リセットに関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ファイル・コミット管理ツールの一覧
! ツール !! 説明
|-
| <code>git_add</code> || ファイルをステージング領域に追加する。
|-
| <code>git_commit</code> || ステージング済みの変更をコミットする。
|-
| <code>git_reset</code> || ステージング済みの変更をリセットする。
|}
</center>
 
==== ブランチ操作ツール ====
下表に、ブランチの一覧表示、作成、切り替えに関するツールを示す。 
 
<center>
{| class="wikitable"
|+ ブランチ操作ツールの一覧
! ツール !! 説明
|-
| <code>git_branch</code> || ブランチを一覧表示する。 ローカル、リモート、全てを指定可能
|-
| <code>git_create_branch</code> || 新しいブランチを作成する。 ベースブランチの指定が可能
|-
| <code>git_checkout</code> || 指定したブランチに切り替える。
|}
</center>
 

== 使用方法 ==
Git MCP Serverを設定後、AIアシスタントに自然言語で指示するだけで、対応するツールが自動的に呼び出される。 
 
==== リポジトリ状態の確認 ====
リポジトリの状態や変更内容を確認する場合の操作例を以下に示す。 
 
* ワーキングツリーの状態を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

リポジトリの現在のステータスを確認してください。
</syntaxhighlight>
*: 
* ステージング前の変更内容を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ステージング前の変更内容を見せてください。
</syntaxhighlight>
*: 
* 2つのブランチ間の差分を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

mainブランチとdevelopブランチの差分を表示してください。
</syntaxhighlight>
 
==== コミット履歴の確認 ====
コミット履歴を確認する場合の操作例を以下に示す。 
 
* 過去1ヶ月のコミット履歴を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

過去1ヶ月のコミット履歴を表示してください。
</syntaxhighlight>
*: 
* 特定のコミットの詳細を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

コミットハッシュ abc1234 の詳細内容を表示してください。
</syntaxhighlight>
 
==== ファイルのステージングとコミット ====
ファイルをステージングしてコミットする場合の操作例を以下に示す。 
 
* 変更ファイルを全てステージングしてコミットする場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

変更ファイルをすべてステージングして、"Fix: typo in README" というメッセージでコミットしてください。
</syntaxhighlight>
 
==== ブランチの操作 ====
ブランチを作成して切り替える場合の操作例を以下に示す。 
 
* 新しいブランチを作成して切り替える場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

developブランチから feature/new-api ブランチを作成して切り替えてください。
</syntaxhighlight>
*: 
* ブランチの一覧を確認する場合
*: <syntaxhighlight lang="text">
# プロンプト例 :

ローカルブランチの一覧を表示してください。
</syntaxhighlight>
 

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| uvxコマンドが見つからない || PATHの設定を確認する。 シェルの設定ファイル (~/.bashrc 等) を再読み込みまたは uvを再インストールする。
|-
| Pythonバージョンが不足している || <code>uv python install 3.10</code> コマンドを実行して、Python 3.10以降をインストールする。
|-
| Gitがインストールされていない || パッケージ管理システムを使用して、Gitをインストールする。
|-
| <code>--repository</code> パスが不正 || 相対パスではなく絶対パスを指定することを推奨する。 パスにスペースが含まれる場合は、クォートで囲む。
|-
| パーミッションエラーが発生する || <code>chmod</code> または <code>chown</code> コマンドを実行して、リポジトリのアクセス権限を調整する。
|-
| JSON設定ファイルの構文エラーが発生する || JSONバリデータを使用して設定ファイルの構文を確認する。 修正後、MCPクライアントを再起動して設定を反映する。
|-
| サーバが起動しない || MCPクライアントを再起動する。 ログファイルを確認してエラーの詳細を調べる。
|}
</center>
 
==== Linuxでの問題 ====
下表に、Linux環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Linuxのトラブルシューティング
! 問題 !! 対処法
|-
| uvコマンドが見つからない || ~/.profile ファイル等に環境変数 <code>PATH</code> が正しく設定されているか確認する。
|-
| パーミッションエラーが発生する || 実行権限を付与する。 例: <code>chmod +x ~/.local/bin/uv</code>
|}
</center>
 
==== MacOSでの問題 ====
下表に、MacOS環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ MacOSのトラブルシューティング
! 問題 !! 対処法
|-
| Apple Silicon環境で、uvコマンドが見つからない || Homebrewを使用して、uvを再インストールする。 <code>brew install uv</code> コマンドを実行する。
|}
</center>
 
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。 
 
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 対処法
|-
| ENOENTエラーが発生する || 設定ファイルに環境変数 (<code>PATH</code> 等) を明示的に指定する。
|-
| パスの区切り文字に関するエラーが発生する || Windowsのパス区切り文字 (<code>\</code>) を使用する。 または、スラッシュ (<code>/</code>) に統一して指定する。
|}
</center>
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Git,MCP,Model Context Protocol,mcp-server-git,Claude,AI,バージョン管理,リポジトリ,Anthropic,uvx,uv,Python
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]

MCPサーバ - Git - 版の履歴