使用说明
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.txt
2.（可选）配置GitHub令牌
复制示例env文件并添加令牌以获得更高的速率限制：
cp .env.example .env
# Edit .env and paste your token
3.运行服务器
python server.py
4.连接到克劳德桌面
将以下内容添加到您的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 |
要创建个人访问令牌，请访问 github/设置/令牌一个经典的代币 无范围 对于公共存储库数据来说就足够了。
查询示例
一旦服务器连接到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文件加载
许可证
麻省理工学院
