MCP Server to Auto commit changes 🛠️

変更を自動コミットする MCP サーバー 🛠️

この実装は、OpenAI の GPT モデルを使用してコミットメッセージを生成する Git 変更分析ツールを提供します。

デモ

特徴

• リポジトリ内の Git の変更を分析します（ステージ済みと未ステージの両方）
• GPT-4o-mini を使用して、Conventional Commits 形式のコミットメッセージを生成します
• 以下の詳細な概要を提供します：
  • 📝 変更されたファイル
  • ✨ 新たに追加されたファイル
  • 🗑️ 削除されたファイル
  • 📄 詳細な変更（ファイルごとに最大10行）
• @modelcontextprotocol/sdk で構築されています
• 各コミットに自動コミット署名を追加します

プロジェクト構成

mcp-server-auto-commit/
├── index.ts        # Main server implementation with git analysis tool
├── package.json    # Project dependencies
├── tsconfig.json   # TypeScript configuration
└── build/         # Compiled JavaScript output

前提条件

• Node.js がインストールされていること
• OpenAI API キー
• 分析対象の Git リポジトリ
• pnpm パッケージマネージャー

はじめに

1. このリポジトリをクローンします：

git clone https://github.com/jatinsandilya/mcp-server-auto-commit.git
cd mcp-server-auto-commit

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

pnpm install

3. 以下いずれかの方法で OpenAI API キーを設定します：

   • 環境変数として設定する：OPENAI_API_KEY=your-api-key
   • コマンドライン引数として渡す：--key your-api-key
   • プロジェクトのルートにある .env ファイルに追加する

4. プロジェクトをビルドします：

pnpm run build

これにより /build/index.js ファイルが生成されます。これはコンパイル済みの MCP サーバースクリプトです。

Cursor での使用

1. Cursor の Settings -> MCP -> Add new MCP server に移動します
2. MCP を設定します：
   • Name：git-auto-commit
   • Type：command
   • Command：node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js --key your-api-key （環境変数に設定していない場合は、your-api-key を実際の OpenAI API キーに置き換えてください）

Claude Desktop での使用

以下の MCP 設定を Claude Desktop の設定に追加します：

{
  "mcpServers": {
    "git-auto-commit": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js", "--key", "your-api-key"]
    }
  }
}

利用可能なツール

git-changes-commit-message

このツールは、リポジトリ内の現在の Git の変更を分析し、OpenAI の GPT-4o-mini モデルを使用してコミットメッセージを生成します。以下を提供します：

• ステータス表示付きの変更されたファイルの一覧
• 新たに追加されたファイルの一覧
• 削除されたファイルの一覧
• 各ファイルの詳細な変更（読みやすさのため、ファイルごとに最大10行）
• Conventional Commits 形式に準拠した生成済みコミットメッセージ
• 自動コミット署名

使用パラメーター：

• autoCommitPath：特定のディレクトリ／ファイルを分析する場合の任意のパスです。指定しない場合は、現在の作業ディレクトリを使用します。

開発

index.ts の実装では、以下の方法を紹介しています：

1. 適切な設定で MCP サーバーをセットアップする
2. コマンドライン引数と環境変数を処理する
3. GPT-4o-mini モデルを使用して OpenAI API と連携する
4. 子プロセスを使用して Git 操作を行う
5. エラー処理とフォールバック機構
6. 詳細な変更分析とフォーマット

実装を変更または拡張するには：

1. index.ts のサーバー設定を更新します：

const server = new McpServer({
  name: "git-auto-commit",
  version: "0.0.1",
});

2. ツールは server.tool() を使用して定義されており、Zod スキーマによる適切なパラメーター検証を備えています。

3. 変更をビルドしてテストします：

pnpm run build

貢献

お気軽にイシューや機能改善のリクエストを送信してください！

ライセンス

MIT