🚀 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

手动安装

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
   

💻 使用示例

基础用法

启动服务器

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 保护。