AI导哈

GitHub仓库解释器

一个MCP服务器，为GitHub Copilot和Cursor等AI助手提供实时访问任何GitHub仓库的能力，无需克隆。

  • by Pranavvr
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Pranavvr/Repo_Explainer_MCP

使用说明

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_MCP

2.创建虚拟环境并安装依赖项

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3.设置您的GitHub令牌

创建一个 .env 项目根目录中的文件：

cp .env.example .env

然后打开 .env 并添加您的令牌：

GITHUB_TOKEN=your_github_token_here

获取令牌 github/设置/令牌.只有 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