Gitスタッフサーバー

このリポジトリには、Git関連の機能を提供するMCP（Model Context Protocol）サーバーとして機能するNode.jsアプリケーションが含まれています。現在、Gitマージコミットとその最初の親との差分を生成するツールを提供しています。

特徴

• **MCP サーバー:**通信に stdio を使用して標準の MCP サーバーとして実行されます。

• get_git_merge_diff

  • Git マージ コミット ハッシュを受け入れます。

  • GenerateMergeDiff.ps1 PowerShell スクリプトを実行します。

  • git show -m --first-parent <commitHash>によって生成されたテキストの diff コンテンツを返します。

Related MCP server: Git Forensics MCP

前提条件

• Node.js (ES モジュールをサポートするバージョン、指定されている場合はpackage.jsonでenginesをチェックし、そうでない場合はtsconfig.jsonターゲット - ES2022 をチェック)

• npm (通常はNode.jsに付属)

• Gitがインストールされ、システムの PATH にアクセスできます。

• PowerShell (Windows) またはpwsh (Linux/macOS) がインストールされ、システムの PATH にアクセスできます。

インストール

1. リポジトリをクローンします。

   git clone <your-repo-url> cd GitStuffServer

2. 依存関係をインストールします:

   npm install

使用法

1. TypeScript コードをビルドします。

   npm run build

   これによりsrc/の TypeScript コードがbuild/内の JavaScript にコンパイルされます。

2. サーバーを実行します。

   • コンパイルされたコードを実行するには:

     npm start

   • 開発モードでビルドして実行するには:

     npm run dev

サーバーが起動し、標準入出力で MCP 要求をリッスンします。

get_git_merge_diffツールの使用

MCP クライアント経由で接続している場合は、次の入力でget_git_merge_diffツールを呼び出すことができます。

• commitHash (文字列): 比較するマージコミットの Git コミットハッシュ (SHA)。

ツールは、差分コンテンツをテキストとして返します。

仕組み

1. MCP サーバー ( src/index.ts ) は、 get_git_merge_diffツールの要求を受け取ります。

2. commitHash入力を検証します。

3. commitHashを渡して、 GenerateMergeDiff.ps1 PowerShell スクリプトを実行します。

4. PowerShell スクリプトはgit show -m --first-parent <commitHash>を実行し、出力 (エラーを含む) をサーバーの現在の作業ディレクトリにあるmerge_changes.diffという名前の一時ファイルに保存します。

5. Node.js サーバーはmerge_changes.diffの内容を読み取ります。

6. サーバーは一時的なmerge_changes.diffファイルを削除します。

7. サーバーは、差分コンテンツ (またはエラー メッセージ) を MCP クライアントに返します。

構成

主要な構成ポイントはsrc/index.ts内の定数として定義されます。

• SERVER_NAME : MCP サーバーによって登録された名前。

• SCRIPT_NAME : 実行する PowerShell スクリプトのファイル名。

• OUTPUT_DIFF_FILE : スクリプトによって作成された一時 diff ファイルの名前。

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、 package.jsonファイルを参照してください。