Git MCP V2

🚀 Git MCP サーバー

このサーバーは、標準化されたインターフェースを通じて、拡張型の Git 操作を提供する Model Context Protocol (MCP) サーバーです。MCP エコシステムと統合され、AI アシスタントに Git 機能を提供します。

🚀 クイックスタート

この Git MCP サーバーを使用することで、標準化されたインターフェースを通じて拡張型の Git 操作が可能になり、MCP エコシステムとの統合を通じて AI アシスタントに Git 機能を提供できます。

✨ 主な機能

• 基本的な Git 操作：init、clone、status、add、commit、push、pull
• ブランチ管理：一覧表示、作成、削除、切り替え
• タグ操作：一覧表示、作成、削除
• リモート管理：一覧表示、追加、削除
• stash 操作：一覧表示、保存、適用
• 一括操作：複数の Git 操作を順番に実行
• GitHub 統合：個人用アクセストークンによる GitHub サポート
• パス解決：オプションのデフォルトパス設定を備えたスマートなパス処理
• エラー処理：カスタムエラータイプを備えた包括的なエラー処理
• リポジトリキャッシュ：効率的なリポジトリ状態管理
• パフォーマンス監視：組み込みのパフォーマンストラッキング

📦 インストール

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

git clone https://github.com/yourusername/git-mcp-v2.git
cd git-mcp-v2

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

npm install

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

npm run build

📚 ドキュメント

設定

MCP 設定ファイルに以下を追加します：

{
  "mcpServers": {
    "git-v2": {
      "command": "node",
      "args": ["path/to/git-mcp-v2/build/index.js"],
      "env": {
        "GIT_DEFAULT_PATH": "/path/to/default/git/directory",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat"
      }
    }
  }
}

環境変数

• GIT_DEFAULT_PATH：（オプション）Git 操作のデフォルトパス
• GITHUB_PERSONAL_ACCESS_TOKEN：（オプション）GitHub 操作に使用する GitHub 個人用アクセストークン

利用可能なツール

基本操作

• init：新しい Git リポジトリを初期化
• clone：リポジトリをクローン
• status：リポジトリの状態を取得
• add：ファイルをステージング
• commit：コミットを作成
• push：コミットをリモートにプッシュ
• pull：リモートから変更を取得

ブランチ操作

• branch_list：すべてのブランチを一覧表示
• branch_create：新しいブランチを作成
• branch_delete：ブランチを削除
• checkout：ブランチを切り替えるか、ワーキングツリーのファイルを復元

タグ操作

• tag_list：タグを一覧表示
• tag_create：タグを作成
• tag_delete：タグを削除

リモート操作

• remote_list：リモートを一覧表示
• remote_add：リモートを追加
• remote_remove：リモートを削除

stash 操作

• stash_list：stash を一覧表示
• stash_save：変更を stash に保存
• stash_pop：stash を適用して削除

一括操作

• bulk_action：複数の Git 操作を順番に実行

開発

# テストを実行
npm test

# カバレッジ付きでテストを実行
npm run test:coverage

# コードチェックツールを実行
npm run lint

# コードをフォーマット
npm run format

📄 ライセンス

MIT

貢献ガイド

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add some amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを作成する