GitHub回购解释器MCP
一个MCP服务器，为GitHub Copilot和Cursor等AI助手提供支持 实时访问任何GitHub存储库 --而不是先克隆它。
问你的AI问题，比如：
- *“这个回购是做什么的？”*
- *“过去7天发生了什么变化？”*
- *“是否有任何依赖项已经过时？”*
- *“解释此特定文件”*
并获得以下支持的答案 实时GitHub数据，而不是过时的训练数据。
______________________________________________________________________
为什么这与单独使用Cursor或Copilot不同
| 仅使用光标/副标 | 此MCP服务器 | |
|---|---|---|
| 解释代码 | ✅ 仅限本地文件 | ✅ 任何地方的任何回购 |
| 实时GitHub数据 | ❌ | ✅ 星星、叉子、活动 |
| 最近的提交和PR | ❌ | ✅ 最近N天 |
| 依赖性审计 | ❌ | ✅ 实时检查PyPI |
| 私有仓库 | ❌ | ✅ 用你的代币 |
| 不需要克隆 | ❌ | ✅ |
______________________________________________________________________
工具
| 工具 | 它做什么 |
|---|---|
summarize_repo | 总结仓库的目的、结构、语言和关键文件 |
explain_file | 获取并解释任何存储库中的特定文件 |
ask_repo | 回答有关回购的任何自由形式的问题 |
recent_changes | 显示最近N天的提交和合并的PR |
analyze_dependencies | 通过PyPI列出依赖关系并标记过时的包 |
______________________________________________________________________
快速入门
1.克隆仓库
git clone https://github.com/Pranavvr/Repo_Explainer_MCP.git
cd Repo_Explainer_MCP2.创建虚拟环境并安装依赖项
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt3.设置您的GitHub令牌
创建一个 .env 项目根目录中的文件：
cp .env.example .env然后打开 .env 并添加您的令牌：
GITHUB_TOKEN=your_github_token_here获取令牌 .只有 repo 需要读取范围。4.连接到VS Code
打开MCP配置文件：
Cmd + Shift + P → MCP: Open User MCP Configuration
添加以下内容：
{
"servers": {
"github-repo-explainer": {
"command": "python3",
"args": ["/absolute/path/to/server.py"],
"env": {
"GITHUB_TOKEN": "your_github_token_here"
}
}
}
}用实际路径替换路径。通过跑步来获得它 pwd 在您的项目文件夹中。
5.重新启动VS Code并开始提问
打开GitHub Copilot聊天并尝试：
What does fastapi/fastapi do?What changed in vercel/next.js in the last 7 days?Are the dependencies in YOUR_USERNAME/YOUR_REPO outdated?______________________________________________________________________
MCP检验员测试
要在没有AI客户端的情况下测试您的工具：
npx @modelcontextprotocol/inspector python3 server.py打开浏览器UI，您可以在其中手动调用每个工具。
______________________________________________________________________
项目结构
github-repo-explainer-mcp/
├── server.py # MCP server — defines and exposes the 5 tools
├── github_client.py # GitHub API wrapper — all data fetching logic
├── .env # Your GitHub token (never committed)
├── .env.example # Token template for others
├── requirements.txt # Dependencies
└── README.md______________________________________________________________________
需求
- Python 3.10+
- GitHub个人访问令牌（免费，只读范围）
- VS Code 1.99+，使用GitHub Copilot或任何兼容MCP的客户端
______________________________________________________________________
建于
- MCP Python SDK --MCP服务器框架
- -GitHub API客户端
- python dotenv --环境变量管理
______________________________________________________________________
许可证
麻省理工学院