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