GitHub Mapper MCP 服务器

GitHub Mapper 是一个模型上下文协议 (MCP) 服务器，它提供用于映射和分析 GitHub 仓库的工具。它允许用户设置 GitHub 个人访问令牌，并检索有关指定仓库的详细信息，包括其结构和摘要统计信息。

功能

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

前提条件

• 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

手动安装

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

用法

1. 启动服务器：

   npm start
   

2. 服务器将在 stdio 上运行，允许它与 MCP 客户端通信。

可用工具

1. set-github-token

设置 GitHub 个人访问令牌以进行身份验证。

• 在此处创建您的个人访问令牌。 选择 Tokens (classic)。 范围：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"]
    }
  }
}

示例输出

仓库分析摘要：

名称：Hello-World
描述：我在 GitHub 上的第一个仓库！
星标：1234
Fork：567
主要语言：JavaScript
创建时间：2023-01-01
上次更新时间：2023-06-15

仓库结构：

{
  "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
}

图片

错误处理

• 如果未设置 GitHub 令牌，您将收到一条错误消息，提示您首先使用 set-github-token 工具。
• 无效的 GitHub URL 或仓库路径将导致相应的错误消息。

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

该项目已获得 MIT 许可证的许可。