🚀 GitHub MCP 服务器指南

GitHub MCP（模型上下文协议）服务器可实现与 Claude 或其他大语言模型（LLM）的交互。该服务器实现了对 GitHub API 的接口，具备代码搜索、问题追踪等一系列实用功能，能有效提升用户在 GitHub 上的操作效率。

✨ 主要特性

• 代码搜索：支持在特定仓库或路径中查找代码片段，可按编程语言、文件路径、扩展名等多维度筛选。
• 问题追踪：方便用户浏览和筛选问题（Issue）和拉取请求（Pull Request），可按类型、状态、标签、作者等条件筛选。
• 评论管理：能够查看和操作问题及拉取请求的评论。
• 审查意见：可处理代码审查（Review）及其相关意见。
• 仓库信息：可获取仓库的基本信息，如贡献者、分支等。

📦 安装指南

个人访问令牌

创建 GitHub 个人访问令牌，确保其具有适当的权限：

1. 访问 Personal access tokens（在 GitHub 设置 > 开发者设置中）。
2. 选择要授予权限的仓库（公共、所有或选定）。
3. 创建一个带有 repo 权限范围的令牌（“对私有仓库的完全控制”）；如果仅处理公开仓库，可以选择 public_repo 范围。
4. 复制生成的令牌。

与 Claude Desktop 使用

在 claude_desktop_config.json 中添加以下配置：

Docker 方式

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "mcp/github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX 方式

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

📚 详细文档

MCP 服务器功能列表

代码搜索功能

• language:javascript：按编程语言筛选。
• repo:owner/name：在特定仓库中搜索。
• path:app/src：按文件路径筛选。
• extension:js：按文件扩展名筛选。
• 示例：q: "import express" language:typescript path:src/

问题与拉取请求搜索

• is:issue 或 is:pr：按类型筛选（问题或拉取请求）。
• is:open 或 is:closed：按状态筛选。
• label:bug：按标签筛选。
• author:username：按作者筛选。
• 示例：q: "memory leak" is:issue is:open label:bug

用户搜索

• type:user 或 type:org：按账户类型筛选（用户或组织）。
• followers:>1000：按关注者数量筛选。
• location:London：按地理位置筛选。
• 示例：q: "fullstack developer" location:London followers:>100

有关详细搜索语法，请参阅 GitHub 的搜索文档。

构建

使用 Docker 构建：

docker build -t mcp/github -f src/github/Dockerfile .

📄 许可证

此 MCP 服务器根据 MIT 许可证发布。这意味着您可以自由地使用、修改和分发该软件，但必须在重新分发的任何文件中包含原始版权声明和许可声明。