Git Stuff Server

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 コンテンツを返します。

前提条件

• 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ファイルを参照してください。