🚀 GitHub 仓库映射 MCP 服务器
GitHub Mapper 是一款基于 Model Context Protocol (MCP) 的服务器，它为用户提供了强大的工具，用于映射和分析 GitHub 仓库。借助该服务器，用户只需设置 GitHub 个人访问令牌，就能轻松获取指定仓库的详细信息，包括仓库结构和摘要统计信息。
🚀 快速开始
GitHub Mapper 是一个 Model Context Protocol (MCP) 服务器，提供用于映射和分析 GitHub 仓库的工具。它允许用户设置 GitHub 个人访问令牌并获取指定仓库的详细信息，包括其结构和摘要统计信息。
✨ 主要特性
- 设置 GitHub 个人访问令牌以进行身份验证
- 映射和分析 GitHub 仓库结构
- 获取仓库摘要信息（stars、forks、语言等）
- 提供详细的仓库文件结构
📦 安装指南
使用 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 - 安装依赖项：
npm install - 构建项目：
npm run build
💻 使用示例
基础用法
启动服务器
npm start
服务器将在标准输入输出上运行，允许与 MCP 客户端通信。
高级用法
1. set-github-token
设置 GitHub 个人访问令牌以进行身份验证。
- 在此处创建您的个人访问令牌 here。选择经典令牌。范围：repo
示例，在您的 IDE 或 Claude Desktop 中：
请设置-github-token为 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
2. map-github-repo
映射 GitHub 仓库结构并提供摘要信息。
示例：
请映射-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"]
}
}
}
示例输出
仓库分析摘要：
名称：Hello-World
描述：我在 GitHub 上的第一个仓库。
Stars 数量：123
Forks 数量：45
语言：JavaScript
贡献者数量：6
文件结构：
- .github/workflows/
- ci.yml
- README.md
- package.json
- src/
- index.js
- App.js
📚 详细文档
先决条件
- Node.js（建议使用 v18.0.0 或更高版本）
- npm（随 Node.js 提供）
- 带有适当权限的 GitHub 个人访问令牌
错误处理
- 如果 Node.js 版本不满足要求，您可能会遇到兼容性问题。
- 如果未设置有效的 GitHub 令牌，映射仓库功能将无法正常工作。
贡献
我们欢迎社区贡献！请参考我们的 CONTRIBUTING.md 文件以了解如何参与。
📄 许可证
此项目受 MIT License 保护。