Git MCP

🚀 Git MCP 使用ガイド

ローカルリポジトリ内のGit操作を管理するためのMCPサーバーです。

🚀 クイックスタート

Git MCPは、ローカルリポジトリ内のGit操作を管理するための便利なMCPサーバーです。以下に、インストール方法や使用方法を説明します。

✨ 主な機能

• ローカルリポジトリ内のGit操作を管理するMCPサーバーを提供します。
• 複数のGit操作に対応しており、リポジトリの一覧表示、タグ管理、コミット情報の取得などが可能です。

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaudeデスクトップにGit MCPを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @kjozsa/git-mcp --client claude

手動インストール

以下のコマンドを使用して手動でインストールできます。

uvx install git-mcp

📚 ドキュメント

設定方法

以下のJSON設定コードスニペットを使用してMCPサーバーを追加します。

{
  "mcpServers": {
    "git-mcp": {
      "command": "uvx",
      "args": ["git-mcp"],
      "env": {
        "GIT_REPOS_PATH": "/path/to/your/git/repositories"
      }
    }
  }
}

環境変数

• GIT_REPOS_PATH：Gitリポジトリを含むディレクトリのパス（必須） サーバーを実行するディレクトリに.envファイルを作成するか、環境に追加することができます。

利用可能なメソッド

list_repositories

設定されたパス内のすべてのGitリポジトリをリストします。

• パラメータ：なし
• 戻り値：リポジトリ名のリスト

get_last_git_tag

指定されたリポジトリの最後のGitタグを取得します。

• パラメータ：
  • repo_name（必須）：Gitリポジトリの名前
• 戻り値：version（タグ名）とdate（作成日）を含む辞書

list_commits_since_last_tag

最後のGitタグから最新のコミットまでのコミット情報をリストします。

• パラメータ：
  • repo_name：Gitリポジトリの名前
  • max_count（オプション）：返される最大コミット数
• 戻り値：hash、author、date、messageを含む辞書のリスト

create_git_tag

指定されたリポジトリに新しいGitタグを作成します。

• パラメータ：
  • repo_name：Gitリポジトリの名前
  • tag_name：作成するタグの名前
  • message（オプション）：注釈情報（指定されない場合、軽量タグが作成されます）
• 戻り値：status、version（タグ名）、date（作成日）、type（注釈または軽量）を含む辞書

push_git_tag

既存のGitタグをデフォルトのリモートリポジトリにプッシュします。

• パラメータ：
  • repo_name：Gitリポジトリの名前
  • tag_name：プッシュするタグの名前
• 戻り値：status、remote（リモート名）、tag（タグ名）、message（成功メッセージ）を含む辞書

refresh_repository

mainブランチをチェックアウトし（またはmasterブランチにフォールバック）、最新の変更をプルしてリポジトリを更新します。

• パラメータ：
  • repo_name：Gitリポジトリの名前
• 戻り値：なし（操作完了後にステータス情報が出力されます）

トラブルシューティング

リポジトリが見つからない場合

「リポジトリが見つかりません」のようなエラーが表示された場合は、以下を確認してください。

1. パス/path/to/your/git/repositoriesが有効で、Gitリポジトリを含んでいることを確認します。
2. リポジトリ名のスペルが正しいことを確認します。

コミットが空の場合

返されるコミットリストが空の場合は、以下の操作を行ってください。

1. タグが作成されていることを確認します。
2. リポジトリにコミット履歴があることを確認します。

開発に関する説明

開発環境をセットアップするには、以下のコマンドを実行します。

uv pip install -r requirements.txt

テストに関する説明

テストを実行するには、以下のコマンドを使用します。

# 基本機能テスト
uvx test

# 拡張機能テスト
python3 tests.py

テストスクリプト

• test：コア機能の迅速なテストを行います。
• tests.py：より多くの使用シナリオをカバーする、より包括的なテストを提供します。

以上のガイドを参照することで、Git MCPサーバーを簡単に設定し、Gitリポジトリを管理することができます。