GitHub 存储库分析器 MCP 服务器
模型上下文协议 (MCP) 服务器,支持大型语言模型实时分析 GitHub 代码库。该服务器提供检索代码库信息、分析问题、访问文档以及可视化活动的工具。
特征
存储库信息工具:检索有关 GitHub 存储库的基本元数据
问题分析工具:列出并分类存储库问题
README 访问资源:访问存储库文档
提交历史工具:分析最近的代码更改
活动分析工具:计算存储库活动指标
可视化工具:创建存储库活动的可视化图表
Related MCP server: GitHub MCP Server
先决条件
Python 3.10 或更高版本
GitHub 帐户和个人访问令牌
安装
克隆此存储库:
创建并激活虚拟环境:
安装依赖项:
使用您的 GitHub API 令牌创建一个
.env文件:
编辑.env文件并将your_github_token_here替换为您的实际 GitHub 个人访问令牌。
用法
运行服务器
要使用 MCP Inspector 以开发模式启动服务器:
这将在您的浏览器中打开一个 Web 界面,您可以在其中测试服务器的工具。
在 Claude Desktop 注册
要使用 Claude Desktop 注册服务器:
注册后,重新启动 Claude Desktop。然后,您可以通过向 Claude 询问有关 GitHub 存储库的问题来与 GitHub 存储库分析器进行交互。
克劳德的示例提示
“您能分析一下 GitHub 存储库‘modelcontextprotocol/python-sdk’并告诉我它的用途和活跃程度吗?”
“openai/openai-python”存储库中排名前 5 的未解决问题是什么?”
“过去 30 天内‘anthropics/anthropic-sdk-python’存储库的活跃程度如何?”
“请阅读‘microsoft/TypeScript’存储库的自述文件并解释其主要功能。”
“生成一个图表,显示过去 60 天内‘facebook/react’的提交活动。”
发展
项目结构
添加新工具
要向服务器添加新工具,请按照以下步骤操作:
在
github_tools.py中的GitHubAPIClient类中添加必要的功能使用
@server.tool装饰器在server.py中向 MCP 服务器注册该工具使用 MCP Inspector 测试该工具
测试
要测试服务器,请使用 MCP 检查器,如“使用方法”部分所述。您还可以为 GitHub API 客户端功能编写单元测试。
安全注意事项
永远不要将你的 GitHub API 令牌提交到版本控制
使用 GitHub 令牌所需的最小范围
注意 GitHub API 速率限制