Git Pr MCP

🚀 Git PR MCP Server

Gitとプルリクエスト操作のためのモデルコンテキストプロトコル（MCP）サーバーです。リポジトリ管理とPRワークフローのためのツールを提供します。

FastMCPを使用して構築されており、デフォルトで0.0.0.0:8000でSSEモードで動作します。

✨ 主な機能

このMCPサーバーは以下のツールと機能を提供します。

コアGit操作（指定されたリポジトリパスで）：

• get_git_status：リポジトリの現在のgitステータスを取得します。
• list_branches：リポジトリ内のすべてのブランチをリスト表示します（オプションでリモートブランチも）。
• create_pr_summary：git diffに基づいてプルリクエストの要約を作成します。
• get_commit_history：ブランチのコミット履歴を取得します。
• get_git_diff：コミット、ブランチ、または作業ディレクトリ間のgit diffを取得します。

自動化されたPRワークフロー（内部管理される「アクティブ」なリポジトリで動作）：

• clone_repository：GitHubリポジトリを管理される一時ディレクトリにクローンし、それを後続の操作の「アクティブ」なリポジトリにします。以前のアクティブなリポジトリの一時ディレクトリを自動的にクリーンアップします。
• create_git_branch：アクティブなリポジトリに新しいブランチを作成します。
• write_file_in_repo：アクティブなリポジトリ内にファイルを作成または上書きします。
• git_commit_changes：すべての変更をステージングし（git add .）、アクティブなリポジトリにコミットします。
• git_push_branch：アクティブなリポジトリの指定されたブランチをリモートオリジンにプッシュします。
• create_github_pr：PyGithubライブラリを使用して、アクティブなリポジトリのGitHubでプルリクエストを作成します。GITHUB_TOKENが必要です。

状態管理：

• サーバーは、現在の「アクティブ」なクローンされたリポジトリの状態（パス、URL、オーナー、名前）をactive_repo_state.jsonファイルに保持します。これにより、サーバーの再起動間である程度の永続性が保たれますが、一時クローンディレクトリ自体はOSによって管理される場合があります。

📦 インストール

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

git clone <repository-url>
cd git-pr-mcp

2. uvを使用してインストールします：

uv sync

💻 使用例

基本的な使用法

サーバーはデフォルトで0.0.0.0:9999でSSEモードで動作し、環境変数で構成されます。以下は.envファイルのサンプルです。

FASTMCP_HOST=0.0.0.0
FASTMCP_PORT=9999
GITHUB_TOKEN=your_github_token

クイックスタート

# デフォルト設定で実行 (0.0.0.0:8000)
uv run python main.py

# またはサーバーモジュールを直接実行
uv run python -m src.git_pr_mcp.server

その後、http://localhost:9999/sseでMCPサーバーにアクセスできます。