GitHub Mapper MCP 服务器
GitHub Mapper 是一个模型上下文协议 (MCP) 服务器，提供用于映射和分析 GitHub 存储库的工具。它允许用户设置 GitHub 个人访问令牌并检索指定存储库的详细信息，包括其结构和摘要统计信息。
特征
- 设置 GitHub 个人访问令牌进行身份验证
- 映射并分析 GitHub 存储库结构
- 检索存储库摘要信息（星标、分支、语言等）
- 提供详细的存储库文件结构
先决条件
- Node.js（建议使用 v18.0.0 或更高版本）
- npm（Node.js 附带）
- 具有适当权限的 GitHub 个人访问令牌
安装
通过 Smithery 安装
要通过Smithery自动为 Claude Desktop 安装 GitHub Mapper：
npx -y @smithery/cli install github-mapper-mcp-server --client claude
手动安装
- 克隆存储库：
git clone https://github.com/your-username/github-mapper-mcp-server.git
cd github-mapper-mcp-server
- 安装依赖项：
- 构建项目：
用法
- 启动服务器：
- 服务器将在 stdio 上运行，从而允许它与 MCP 客户端进行通信。
可用工具
1. set-github-token
设置 GitHub 个人访问令牌进行身份验证。
- 在此创建您的个人访问令牌。选择“令牌（经典）”。范围：repo
例如，在您的 IDE 或 Claude Desktop 中：
Please set-github-token to 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
2. map-github-repo
映射 GitHub 存储库结构并提供摘要信息。
例子：
Please map-github-repo https://github.com/dazeb/MCP-Github-Mapper
在 Cline 或 Roo-Cline MCP 客户端中手动安装：
{
"mcpServers": {
"github-mapper": {
"command": "node",
"args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"]
}
}
}
示例输出
Repository Analysis Summary:
Name: Hello-World
Description: My first repository on GitHub!
Stars: 1234
Forks: 567
Primary Language: JavaScript
Created: 2023-01-01
Last Updated: 2023-06-15
Repository Structure:
{
"src": {
"components": {
"Header.js": null,
"Footer.js": null
},
"pages": {
"index.js": null,
"about.js": null
},
"styles": {
"global.css": null
}
},
"public": {
"images": {
"logo.png": null
},
"favicon.ico": null
},
"package.json": null,
"README.md": null
}
图片
运行评估
evals 包会加载一个 mcp 客户端，然后运行 index.ts 文件，因此测试之间无需重新构建。您可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可在此处找到。
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts
错误处理
- 如果未设置 GitHub 令牌，您将收到一条错误消息，提示您先使用
set-github-token工具。 - 无效的 GitHub URL 或存储库路径将导致相应的错误消息。
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
执照
该项目已获得 MIT 许可。