Git Pr MCP

🚀 Git PR MCP Server

Git PR MCP Server 是一個用於 Git 和拉取請求（Pull Request）操作的模型上下文協議（MCP）服務器，為倉庫管理和 PR 工作流提供了實用工具。它基於 FastMCP 構建，默認以 SSE 模式運行在 0.0.0.0:8000。

🚀 快速開始

運行默認配置（0.0.0.0:8000）

uv run python main.py

直接運行服務器模塊

uv run python -m src.git_pr_mcp.server

啟動後，你可以通過 http://localhost:9999/sse 訪問 MCP 服務器。

✨ 主要特性

本 MCP 服務器提供了以下工具和功能：

核心 Git 操作（在指定的倉庫路徑上）

• get_git_status：獲取倉庫的當前 Git 狀態。
• list_branches：列出倉庫中的所有分支（可選擇包含遠程分支）。
• create_pr_summary：根據 Git 差異為拉取請求創建摘要。
• get_commit_history：獲取某個分支的提交歷史。
• get_git_diff：獲取提交、分支或工作目錄之間的 Git 差異。

自動化 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 文件中。這允許服務器在重啟後保留部分狀態，不過臨時克隆目錄本身可能由操作系統管理。

📦 安裝指南

克隆本倉庫

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

使用 uv 進行安裝

uv sync

💻 使用示例

基礎用法

服務器默認以 SSE 模式運行在 0.0.0.0:9999，並通過環境變量進行配置。以下是一個示例 .env 文件：

FASTMCP_HOST=0.0.0.0
FASTMCP_PORT=9999
GITHUB_TOKEN=your_github_token