MCP服务器:GitHub Intelligence
一 MCP(模型上下文协议) 服务器,让Claude直接访问GitHub的REST API,用于存储库分析、问题跟踪、拉取请求状态、贡献者洞察和代码搜索。
使用官方Anthropic MCP Python SDK构建(FastMCP).
______________________________________________________________________
特性
| 工具 | 说明 |
|---|---|
get_repository_info | 全面的回购详细信息——星型、分叉、语言、许可证、主题等 |
list_issues | 按州和标签浏览和筛选问题 |
list_pull_requests | 列出带有分支机构信息、草稿/合并状态的PR |
get_contributor_stats | 按提交次数排名的顶级贡献者 |
search_repositories | 使用语言和排序过滤器搜索所有GitHub |
______________________________________________________________________
快速开始
1.安装依赖项
pip install -r requirements.txt2.(可选)配置GitHub令牌
复制示例env文件并添加令牌以获得更高的速率限制:
cp .env.example .env
# Edit .env and paste your token3.运行服务器
python server.py4.连接到克劳德桌面
将以下内容添加到您的Claude Desktop配置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"github-intel": {
"command": "python",
"args": ["/absolute/path/to/server.py"]
}
}
}重新启动克劳德桌面。GitHub上的五个工具将自动显示。
______________________________________________________________________
认证
服务器以两种模式工作:
| 模式 | 速率限制 | 设置 |
|---|---|---|
| 未认证 | 60个请求/小时 | 无需 |
| 已验证 | 5000个请求/小时 | 设置 GITHUB_TOKEN 在 .env |
要创建个人访问令牌,请访问 一个经典的代币 无范围 对于公共存储库数据来说就足够了。
______________________________________________________________________
查询示例
一旦服务器连接到Claude,试着问:
- *“给我一个facebook/react存储库的概述。”*
- *“显示vercel/next.js中标记为'bug'的未解决问题。”*
- *“列出最近对rust-lang/rust的拉取请求。”*
- *“谁是torvalds/linux的最大贡献者?”*
- *“在GitHub上搜索最受欢迎的Python机器学习框架。”*
______________________________________________________________________
速率限制
GitHub对每个IP(未经身份验证)或每个令牌(经过身份验证)强制执行速率限制。
- 无令牌: 每小时60个请求。
- 使用令牌: 每小时5000个请求。
服务器检测到速率限制错误(HTTP 403),并返回一条带有重置时间戳的清除消息,以便您知道何时重试。
______________________________________________________________________
技术栈
- Python 3.10+
- 主控程序 --官方人类MCP SDK(FastMCP)
- httpx --异步HTTP客户端
- 派迪克 --数据验证(MCP内部使用)
- python dotenv —
.env文件加载
______________________________________________________________________
许可证
麻省理工学院
