Git Stuff Server

Git Stuff Server

このリポジトリには、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> で生成されたテキスト形式の差分コンテンツを返します。

前提条件

• Node.js（ES Modules に対応したバージョン。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：スクリプトが作成する一時差分ファイルの名前。

ライセンス

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