GitHub PR MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GitHub PR MCP Serveranalyze PR #42 in my repository"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GitHub PR MCP Server - MCP&Agent Challenge
项目简介
GitHub PR MCP Server 是一个基于 Gradio 和 Flask 的 MCP(Model Context Protocol)服务器,专门用于自动化处理 GitHub Pull Request 事件。当 GitHub Webhook 检测到 PR 时,系统会自动将 PR 内容转发给 AI 进行分析,生成结构化的日志摘要,并发送到飞书知识库。
核心功能
MCP 协议支持: 完全兼容 MCP 协议,可作为工具供 LLM 使用
自动化 Webhook 处理: 自动接收和处理 GitHub PR 事件
AI 驱动分析: 使用 OpenAI API 智能分析代码变更
飞书知识库集成: 自动将分析结果发送到飞书
双界面支持: 提供 Gradio Web UI 和 Flask API 两种接口
安全验证: 支持 GitHub Webhook 签名验证
丰富信息: 提取完整的 PR 信息(标题、作者、链接等)
技术架构
GitHub Webhook → MCP Server → AI Analysis → 飞书知识库
↓ ↓ ↓ ↓
PR 事件 自动处理 智能摘要 结构化存储部署指南
环境要求
Python 3.8 或更高版本
OpenAI API 密钥
GitHub 个人访问令牌(可选)
飞书 Webhook URL(可选)
安装方法
方法一:使用 uvx(推荐)
# 安装 uvx(如果尚未安装)
pip install uvx
# 直接运行
uvx github-pr-mcp-server@latest方法二:从 PyPI 安装
pip install github-pr-mcp-server方法三:从源码安装
git clone https://github.com/your-username/github-pr-mcp-server.git
cd github-pr-mcp-server
pip install -e .环境变量配置
创建 .env 文件或设置环境变量:
# 必需配置
OPENAI_API_KEY=your_openai_api_key_here
# 可选配置
WEBHOOK_SECRET=your_github_webhook_secret
FEISHU_WEBHOOK_URL=your_feishu_webhook_url
GITHUB_TOKEN=your_github_token
MCP_SERVER_TYPE=gradio # 或 flask
WEBHOOK_PORT=5000
GRADIO_PORT=8080启动服务器
# 启动 Gradio MCP 服务器(默认)
github-pr-mcp-server
# 或指定服务器类型
MCP_SERVER_TYPE=flask github-pr-mcp-serverMCP 客户端配置
支持 SSE 的客户端(如 Claude Desktop)
{
"mcpServers": {
"github-pr-mcp-server": {
"command": "uvx",
"args": ["github-pr-mcp-server@latest"],
"env": {
"OPENAI_API_KEY": "YOUR_OPENAI_API_KEY",
"WEBHOOK_SECRET": "YOUR_WEBHOOK_SECRET",
"FEISHU_WEBHOOK_URL": "YOUR_FEISHU_WEBHOOK_URL",
"GITHUB_TOKEN": "YOUR_GITHUB_TOKEN"
}
}
}
}不支持 SSE 的客户端
{
"mcpServers": {
"github-pr-mcp-server": {
"command": "npx",
"args": [
"mcp-remote",
"http://your-server:port/gradio_api/mcp/sse"
]
}
}
}使用示例
自动化 PR 处理流程
配置 GitHub Webhook
在 GitHub 仓库设置中添加 Webhook
URL:
http://your-server:5000/webhook/github事件类型: 选择 "Pull requests"
密钥: 设置
WEBHOOK_SECRET
创建 Pull Request
在 GitHub 上创建新的 PR
系统自动接收 Webhook 事件
AI 分析处理
系统自动获取 PR 差异内容
使用 OpenAI API 分析代码变更
生成结构化摘要
飞书通知
自动将摘要发送到飞书知识库
包含 PR 链接、作者、变更详情等信息
MCP 函数使用
1. 分析 PR 差异
# 在 MCP 客户端中调用
result = mcp_analyze_pr(
diff_content="diff --git a/file.py b/file.py...",
openai_api_key="your_key"
)
print(result) # 输出 AI 生成的摘要2. 处理 Webhook 载荷
# 处理 GitHub Webhook 事件
result = mcp_process_webhook(
webhook_payload='{"action": "opened", "pull_request": {...}}',
openai_api_key="your_key",
feishu_webhook_url="your_webhook_url"
)
print(result) # 输出处理结果3. 手动分析
# 手动分析代码变更
summary = mcp_manual_analysis(
diff_content="your_diff_content",
openai_api_key="your_key",
feishu_webhook_url="your_webhook_url"
)
print(summary)输出示例
AI 分析结果
## 变更摘要
本次 PR 主要添加了用户认证功能和错误处理机制。
## 详细分析
1. 新增了用户登录模块 (auth.py)
- 实现了 JWT 令牌生成和验证
- 添加了密码加密功能
2. 改进了错误处理 (error_handler.py)
- 统一了错误响应格式
- 添加了详细的错误日志记录
3. 更新了 API 文档
- 添加了新的端点说明
- 更新了认证流程文档
## 建议
- 建议添加单元测试覆盖新功能
- 考虑添加速率限制防止暴力攻击
- 建议在生产环境使用 HTTPS飞书消息格式
{
"msg_type": "post",
"content": {
"post": {
"zh_cn": {
"title": "PR #123: 添加用户认证功能",
"content": [
[{"tag": "text", "text": "📋 **PR 摘要**\n\n"}],
[{"tag": "text", "text": "🔗 **链接**: https://github.com/repo/pull/123\n"}],
[{"tag": "text", "text": "👤 **作者**: username\n"}],
[{"tag": "text", "text": "📝 **变更摘要**: 添加了用户认证功能...\n"}],
[{"tag": "text", "text": "📅 **处理时间**: 2024-01-15 14:30:00\n"}]
]
}
}
}
}API 端点
Gradio MCP 服务器
Web 界面:
http://localhost:8080MCP 端点:
http://localhost:8080/gradio_api/mcp/sseWebhook:
http://localhost:8080/webhook/github
Flask MCP 服务器
Webhook:
http://localhost:5000/webhook/githubMCP 分析:
POST /mcp/analyzeMCP Webhook:
POST /mcp/process_webhook健康检查:
GET /health
配置验证
系统启动时会自动验证配置:
🔍 验证环境配置...
✅ 所有环境变量已配置错误处理
API 密钥错误: 显示友好的错误信息
网络连接失败: 自动重试机制
Webhook 验证失败: 返回 401 状态码
AI 分析失败: 提供详细的错误原因
监控
健康检查端点:
/health实时日志: 控制台输出详细处理信息
错误追踪: 完整的异常堆栈信息
安全考虑
Webhook 签名验证: 防止伪造请求
API 密钥保护: 支持环境变量配置
HTTPS 支持: 生产环境建议使用 HTTPS
访问控制: 可配置 IP 白名单
MCP 协议合规性
标准工具格式: 符合 MCP 工具规范
类型注解: 完整的参数类型定义
文档字符串: 详细的函数说明
错误处理: 标准的错误响应格式
开发信息
项目地址: https://github.com/your-username/github-pr-mcp-server
问题反馈: https://github.com/your-username/github-pr-mcp-server/issues
文档: https://github.com/your-username/github-pr-mcp-server#readme
许可证: MIT License
贡献指南
欢迎提交 Issue 和 Pull Request!
Fork 项目
创建功能分支
提交更改
推送到分支
创建 Pull Request
许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AAAxianyu/MCP_PRDairy'
If you have feedback or need assistance with the MCP directory API, please join our Discord server