GitHub Repository Analyzer MCP 服务器

一个模型上下文协议 (MCP) 服务器，使大型语言模型能够实时分析 GitHub 仓库。此服务器提供用于检索仓库信息、分析问题、访问文档和可视化活动的工具。

功能

• 仓库信息工具: 检索关于 GitHub 仓库的基本元数据
• 问题分析工具: 列出并分类仓库问题
• README 访问资源: 访问仓库文档
• 提交历史工具: 分析最近的代码更改
• 活动分析工具: 计算仓库活动指标
• 可视化工具: 创建仓库活动的可视化图表

前提条件

• Python 3.10 或更高版本
• GitHub 帐户和个人访问令牌

安装

1. 克隆此仓库：

git clone <repository-url>
cd github-repo-analyzer

2. 创建并激活虚拟环境：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

4. 创建一个包含您的 GitHub API 令牌的 .env 文件：

cp .env.example .env

编辑 .env 文件，并将 your_github_token_here 替换为您的实际 GitHub 个人访问令牌。

用法

运行服务器

要使用 MCP Inspector 在开发模式下启动服务器：

mcp dev src/server.py

这将在您的浏览器中打开一个 Web 界面，您可以在其中测试服务器的工具。

向 Claude Desktop 注册

要向 Claude Desktop 注册服务器：

mcp install src/server.py

注册后，重新启动 Claude Desktop。然后，您可以通过向 Claude 询问有关 GitHub 仓库的问题来与 GitHub Repository Analyzer 交互。

Claude 的示例提示

• "你能分析 GitHub 仓库 'modelcontextprotocol/python-sdk' 并告诉我它的用途和活动级别吗？"
• " 'openai/openai-python' 仓库中排名前 5 的未解决问题是什么？"
• "在过去 30 天里，'anthropics/anthropic-sdk-python' 仓库的活跃程度如何？"
• "请阅读 'microsoft/TypeScript' 仓库的 README 并解释其主要功能。"
• "生成一个图表，显示 'facebook/react' 在过去 60 天内的提交活动。"

开发

项目结构

github-repo-analyzer/
├── src/
│   ├── github_tools.py  # GitHub API 客户端实现
│   └── server.py        # MCP 服务器实现
├── requirements.txt     # 依赖项
├── .env.example         # 示例环境变量
├── .gitignore           # Git 忽略文件
└── README.md            # 项目文档

添加新工具

要向服务器添加新工具，请按照以下步骤操作：

1. 将必要的功能添加到 github_tools.py 中的 GitHubAPIClient 类
2. 使用 @server.tool 装饰器在 server.py 中向 MCP 服务器注册该工具
3. 使用 MCP Inspector 测试该工具

测试

要测试服务器，请使用“用法”部分中描述的 MCP Inspector。 您还可以为 GitHub API 客户端功能编写单元测试。

安全注意事项

• 永远不要将您的 GitHub API 令牌提交到版本控制
• 为您的 GitHub 令牌使用所需的最小范围
• 注意 GitHub API 速率限制

许可证

MIT 许可证