Git MCP サーバー
Gitリポジトリと連携するためのツールを提供するMCP（Model Context Protocol）サーバー。LLMとAIエージェントがMCP標準を介して、クローン、コミット、プッシュ、プル、ブランチ、差分、ログ、ステータスなどのGit操作を実行できるようにします。
cyanheads/mcp-ts-template上に構築されたこのサーバーは、モジュラー アーキテクチャに従います。
開発者向けメモ: このリポジトリには、コードベース パターン、ファイルの場所、およびコード スニペットのクイック リファレンスを含む、LLM コーディング エージェントの開発者向けチート シートとして機能する.clinerulesファイルが含まれています。
目次
Related MCP server: GitHub MCP Server
概要
シームレスな Git 統合により、AI エージェントと開発ツールを強化します。
Git MCP サーバーはブリッジとして機能し、モデル コンテキスト プロトコル (MCP) を理解するアプリケーション (MCP クライアント) (高度な AI アシスタント (LLM)、IDE 拡張機能、カスタム スクリプトなど) がローカル Git リポジトリと直接安全にやり取りできるようにします。
複雑なスクリプトや手動の CLI の代わりに、ツールはこのサーバーを活用して次のことを行うことができます。
Git ワークフローを自動化: リポジトリのクローン作成、ブランチの作成、変更のステージング、作業のコミット、更新のプッシュ、タグの管理をプログラムで実行します。
リポジトリの洞察を得る: ホスト アプリケーションを離れずに、ステータスを確認し、ログを表示し、変更を比較し、Git オブジェクトを検査します。
Git を AI 駆動型開発に統合: LLM がコーディングまたはリファクタリング タスクの一環としてバージョン管理を管理できるようにします。
堅牢なmcp-ts-templateをベースに構築されたこのサーバーは、MCP標準を介してGit機能を公開するための、標準化された安全かつ効率的な方法を提供します。Node.jsのchild_processモジュールを使用して、システムにインストールされている標準のgitコマンドラインツールを安全に実行することでこれを実現し、互換性を確保しながらGitのパワーを最大限に活用します。
特徴
コアユーティリティ（テンプレートから）
mcp-ts-templateによって提供される堅牢なユーティリティを活用します。
ログ記録: 機密データの編集を伴う構造化された構成可能なログ記録 (ファイルのローテーション、コンソール、MCP 通知)。
エラー処理: 集中化されたエラー処理、標準化されたエラー タイプ (
McpError)、および自動ログ記録。設定: 環境変数の読み込み (
dotenv)。入力検証/サニタイズ: スキーマ検証とカスタム サニタイズ ロジック (パスに重要) に
zod使用します。リクエスト コンテキスト: 一意のリクエスト ID による操作の追跡と相関。
型の安全性: TypeScript と Zod スキーマによって強制される強力な型付け。
HTTP トランスポート オプション: SSE、セッション管理、CORS サポートを備えた組み込み Express サーバー。
Git操作
直接 Git CLI 実行: Node.js
child_processを介して標準のgitコマンドライン ツールを安全に実行することで Git と対話し、完全な互換性と Git の機能へのアクセスを確保します。包括的なコマンド カバレッジ: 幅広い Git コマンドを MCP ツールとして公開します (ツールセクションを参照)。
リポジトリインタラクション: ステータスのチェック、ブランチ、ステージング、コミット、フェッチ、プル、プッシュ、比較、ログ記録、リセット、タグ付けなどをサポートします。
作業ディレクトリ管理: 複数の Git 操作にわたってコンテキストを永続化するために、セッション固有の作業ディレクトリを設定およびクリアできます。
安全機能:
git cleanやgit reset --hardなどの潜在的に破壊的な操作に対するチェックが含まれ、明示的な確認が必要です。コミット署名：検証済みコミットのGPGまたはSSH署名をサポートします。GIT_SIGN_COMMITS環境変数とサーバー側のGit設定によって制御されます。署名失敗時に未署名コミットにフォールバックするためのオプションツールパラメータも
GIT_SIGN_COMMITSれています。
インストール
前提条件
npm経由でインストール
パッケージをグローバルにインストールします。
npm install @cyanheads/git-mcp-server
ソースからインストール
リポジトリをクローンします。
git clone https://github.com/cyanheads/git-mcp-server.git cd git-mcp-server依存関係をインストールします:
npm installプロジェクトをビルドします。
npm run build (or `npm run rebuild`)これにより、TypeScript コードが
dist/ディレクトリ内の JavaScript にコンパイルされ、エントリ ポイントが実行可能になります。
構成
環境変数
環境変数を使用してサーバーを設定します。プロジェクトルートに.envファイルを作成するか（ .env.exampleからコピー）、環境変数を環境に設定します。
変数 | 説明 | デフォルト |
| トランスポート メカニズム:
または
。 |
|
| HTTPサーバーのポート（
の場合）。ビジー状態の場合は次のポートを再試行します。 |
|
| HTTP サーバーのホスト アドレス (
の場合)。 |
|
| CORS に許可されるオリジンのコンマ区切りリスト (
の場合)。 | （なし） |
| ログレベル（
、
、
、
、
、
、
、
）。テンプレートから継承されます。 |
|
|
ツールによるコミットの署名を有効にするには、
に設定します。サーバー側の Git/キー設定が必要です（下記参照）。 |
|
| 認証トークンの署名/検証用の秘密キー (将来認証が有効になった場合に必要)。 |
|
MCPクライアント設定
MCP クライアント設定に追加します (例: cline_mcp_settings.json ):
プロジェクト構造
コードベースは、 src/ディレクトリ内でモジュール構造に従います。
詳細なファイル ツリーについては、 npm run treeを実行するか、 docs/tree.mdを参照してください。
ツール
Git MCP サーバーは、モデル コンテキスト プロトコルを介して呼び出すことができる、Git リポジトリと対話するためのツール スイートを提供します。
ツール名 | 説明 | 主な議論 |
| 指定されたファイルまたはパターンをステージングします。 |
、
|
| ブランチを管理します (一覧表示、作成、削除、名前変更、現在の表示)。 |
、
、
、
、
、
、
、
|
| ブランチを切り替えたり、作業ツリー ファイルを復元したりします。 |
、
、
、
|
| 既存のコミットによって導入された変更を適用します。 |
、
、
、
、
、
|
| 追跡されていないファイルを削除します。force
。 |
、
、
、
、
|
| セッション固有の作業ディレクトリをクリアします。 | （なし） |
| 指定された絶対パスにリポジトリのクローンを作成します。 |
、
、
、
、
|
| ステージングされた変更をコミットします。作成者によるオーバーライド、署名制御をサポートします。 |
、
、
、
、
、
|
| コミット、作業ツリーなどの間の変更を表示します。 |
、
、
|
| 他のリポジトリからオブジェクトと参照をダウンロードします。 |
、
、
、
、
|
| 指定された絶対パスに新しい Git リポジトリを初期化します。初期ブランチのデフォルトは「main」です。 |
、
、
、
|
| コミット ログを表示します。 |
、
、
、
、
、
|
| 指定されたブランチを現在のブランチにマージします。 |
、
、
、
、
、
|
| 別のリポジトリまたはローカル ブランチから取得して統合します。 |
、
、
、
、
|
| ローカル参照を使用してリモート参照を更新します。 |
、
、
、
、
、
、
、
、
|
| 別のベースチップの上にコミットを再適用します。 |
、
、
、
、
、
、
、
|
| リモート リポジトリを管理します (一覧表示、追加、削除、表示)。 |
、
、
、
|
| 現在のHEADを指定された状態にリセットします。ソフト、ミックス、ハードモードをサポートします。 「hard」は注意して使用してください 。 |
、
、
|
| デフォルトの作業ディレクトリを設定します。リポジトリが存在しない場合は、必要に応じて初期化できます。絶対パスが必要です。 |
、
、
|
| Git オブジェクト (コミット、タグなど) に関する情報を表示します。 |
、
、
|
| 保存された変更を管理します (リスト、適用、ポップ、ドロップ、保存)。 |
、
、
|
| リポジトリのステータス (ブランチ、ステージング済み、変更済み、追跡されていないファイル) を取得します。 |
|
| タグを管理します (リスト、注釈付き/軽量の作成、削除)。 |
、
、
、
、
、
|
| Git ワークツリーを管理します (リスト、追加、削除、移動、プルーニング)。 |
、
、
、
、
、
、
、
、
、
、
|
注:
リソース
MCP リソースはこのバージョン (v2.0.12) では実装されていません。
このバージョンでは、最新のmcp-ts-templateとMCP SDK v1.12.0に基づいてリファクタリングされたGitツール実装に重点を置いています。これまで利用可能だったリソース機能は、今回のメジャーアップデート中に一時的に削除されました。
MCP リソース アクセスが必要な場合 (たとえば、サーバー経由でファイル コンテンツを直接読み取る場合) は、安定版の**v1.2.4 リリース**を使用してください。
将来の開発により、後続のリリースでリソース機能が再導入される可能性があります。
**注:**このバージョン (v2.0.0) は、最新の MCP SDK に基づいてコア Git ツールのリファクタリングとアップデートに重点を置いています。MCP リソース機能はこのバージョンでは実装されていません。リソースへのアクセスには、 v1.2.4 をご利用ください。
発達
ビルドとテスト
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。