生产MCP服务器

Name: 生产MCP服务器
Author: valentin-harrang

作者：valentin-harrang4 星标更新：2025-10-30

安装使用来源：spider==github.com

项目介绍

pr-mcp-server

MCP（模型上下文协议）服务器用于通过AI自动化创建Pull Request。分析Git分支，生成描述、标题，建议审阅者，并执行代码审查。旨在加快审阅过程并提高PR质量。

✨ 特性

🚀 统一PR工作流 - 通过一个命令（“创建PR”）完成PR创建
🧠 AI驱动的代码审查 - 集成到PR描述中的上下文感知审查
🔍 项目上下文分析 - 检测TypeScript、国际化(i18n)、状态管理、样式、测试框架
📝 PR生成 - 生成PR描述（标准、详细、最小模板 | 英文/法文）
🏷️ 常规标题 - 生成常规PR标题（feat、fix、docs等）
🎨 智能GIF - 根据工作类型自动添加相关GIF
👥 自动审阅者 - 根据贡献历史建议并添加审阅者
🔎 代码审查 - 提供可操作反馈的自动化代码审查
🤖 AI就绪 - 与MCP Inspector、Cursor和Claude Desktop兼容

📚 文档

配置指南 - Cursor、Claude Desktop和MCP Inspector的设置
工具参考 - 所有可用工具的详细描述
GitHub集成 - 在GitHub上使用自动审阅者创建PR
智能审阅者 - 审阅者检测的工作原理及故障排除
智能GIF选择 - 自动GIF选择及速率限制处理
示例 - 真实用例示例
架构 - 项目结构和设计

🚀 快速开始

要求

Node.js 18+
一个Git仓库

安装

本地开发：

npm install
npm run build

全局安装（推荐）：

npm link

这将使pr-mcp-server命令全局可用。

使用MCP Inspector测试

在npm link之后运行：

npx @modelcontextprotocol/inspector pr-mcp-server

Inspector将列出所有可用工具。在Git仓库内运行以获得全部功能。

与Cursor一起使用

添加到~/.cursor/mcp.json：

{
  "mcpServers": {
    "pr-mcp-server": {
      "command": "pr-mcp-server",
      "cwd": "{workspaceFolder}"
    }
  }
}

重启Cursor，然后询问：

“创建PR” - 使用统一工作流（推荐）
“生成我的PR标题”
“分析我的分支并生成PR描述”
“在GitHub上创建带有审阅者的PR”

详情见配置指南。

🎯 统一PR创建工作流（AI驱动）

当你说到**“创建PR”**时，Claude（AI）会协调一个智能工作流程：

工作原理

调用review工具 - 收集全面的项目上下文：
- 检测语言/框架（TypeScript、PHP、Python、Go、Rust等）
- 识别技术（i18n、状态管理、样式、测试）
- 提取完整的差异和提交历史
- 返回包含所有上下文的结构化提示
Claude分析并生成审查 - 真正的AI驱动分析：
- 自动理解项目惯例
- 识别特定于你的技术栈的问题
- 提供智能、上下文感知的建议
- 适用于任何语言/框架（不仅仅是TypeScript！）
使用审查调用create_pr_complete - 创建完整的PR：
- 生成符合常规提交风格的标题
- 创建全面的描述
- 包含Claude的智能审查
- 根据PR类型添加智能GIF
- 创建/更新GitHub PR
- 根据Git历史分配审阅者

为什么它很智能

与基于规则的工具不同，它使用Claude的智能来：

✅ 适应任何项目（PHP Laravel、Python Django、Go、Rust等）
✅ 理解复杂的模式和上下文
✅ 提供针对项目的建议
✅ 检测违反你项目惯例的行为

示例：在一个PHP Laravel项目中，它会标记SQL注入漏洞并建议使用Eloquent ORM。在一个React i18n项目中，它会捕获硬编码字符串。这一切都是自动的！

示例用法

# 在Cursor或Claude Desktop中，只需说：
"创建PR"

# Claude将自动：
# 1. 调用'review'获取项目上下文
# 2. 分析上下文并生成智能审查
# 3. 使用审查调用'create_pr_complete'
# 4. 返回PR URL

# 带有特定选项：
"创建英文详细模板的PR"
"创建没有审阅者的草稿PR"

详情见AI_POWERED_REVIEW.md了解AI审查的工作原理。

🛠️ 可用工具

工具	描述	推荐
`create_pr_complete`	🚀 统一工作流 - 使用AI审查完成PR创建	⭐ 是
`create_pr`	在GitHub上创建带有自动审阅者的PR（无AI审查）
`analyze_branch`	分析分支之间的差异
`generate_pr_title`	生成常规PR标题
`generate_pr_description`	生成PR描述
`generate_pr_complete`	生成标题和描述
`suggest_reviewers`	根据Git历史建议审阅者
`review`	自动代码审查（上下文感知）

推荐：使用create_pr_complete获得最佳体验。它结合了所有功能，并具有智能、上下文感知的代码审查。

详情见工具参考。

📦 实用脚本

npm run build        # 将TypeScript编译到dist/
npm start            # 启动MCP服务器
npm test             # 运行测试
npm run test:watch   # 监控模式下运行测试
npm run test:ui      # 带UI运行测试
npm run dev          # 开发模式运行

🐛 故障排除

“不是git仓库”：在Git仓库内运行服务器
ESM导入问题：使用Node 18+并构建项目（npm run build）
权限错误：确保你的shell可以访问仓库
“需要GitHub令牌”：设置GITHUB_TOKEN环境变量
“远程分支不存在”：先推送你的分支

详情见GitHub集成进行更多故障排除。

📄 许可证

MIT