GitHub Mapper MCP Server

基本能力

产品定位

GitHub Mapper 是一个专门用于分析和映射 GitHub 仓库的工具，帮助开发者快速了解仓库结构和关键信息。

核心功能

• 设置 GitHub 个人访问令牌进行身份验证
• 映射和分析 GitHub 仓库结构
• 获取仓库摘要信息（如星标数、分支数、主要语言等）
• 提供详细的仓库文件结构

适用场景

• 快速了解新接触的 GitHub 仓库结构
• 分析开源项目的组成和依赖关系
• 获取仓库的基本统计信息
• 在开发环境中集成 GitHub 仓库分析功能

工具列表

1. set-github-token：设置 GitHub 个人访问令牌用于身份验证
2. map-github-repo：映射 GitHub 仓库结构并提供摘要信息

常见问题解答

• 如果未设置 GitHub 令牌，会收到错误提示要求先使用 set-github-token 工具
• 无效的 GitHub URL 或仓库路径会导致相应的错误信息

使用教程

使用依赖

• Node.js (v18.0.0 或更高版本)
• npm (随 Node.js 一起安装)
• 具有适当权限的 GitHub 个人访问令牌

安装教程

通过 Smithery 安装

npx -y @smithery/cli install github-mapper-mcp-server --client claude

手动安装

1. 克隆仓库：

git clone https://github.com/your-username/github-mapper-mcp-server.git
cd github-mapper-mcp-server

1. 安装依赖：

npm install

1. 构建项目：

npm run build

调试方式

1. 启动服务器：

npm start

1. 服务器将在 stdio 上运行，可以与 MCP 客户端通信

2. 在 Cline 或 Roo-Cline MCP 客户端中手动安装：

{
  "mcpServers": {
    "github-mapper": {
      "command": "node",
      "args": ["/home/user/Documents/Cline/MCP/github-mapper/build/index.js"]
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款。