🚀 GitHub MCP 服务器

GitHub MCP（Model Context Protocol）服务器为用户提供了强大的代码搜索、问题跟踪等功能，能有效提升在 GitHub 上的开发与管理效率。

🚀 快速开始

若要使用 GitHub MCP 服务器，需先创建 GitHub 个人访问令牌，再根据自身需求将相应配置添加到 claude_desktop_config.json 文件中。若需自定义镜像，还可使用 Docker 进行构建。

✨ 主要特性

MCP 功能

GitHub MCP 服务器具备以下实用功能：

1. 代码搜索：借助特定语法，可在指定仓库或路径中精准搜索代码片段。
2. 问题跟踪：方便检索和管理 GitHub 上的问题与拉取请求。
3. 审查评论：能查看并操作与 Pull Request 相关的审查评论。
4. 状态检查：可获取 Pull Request 的综合状态检查结果。
5. 分支更新：自动将 Pull Request 分支更新为最新版本。

搜索语法

代码搜索

• 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 搜索文档。

📦 安装指南

个人访问令牌

创建 GitHub 个人访问令牌的步骤如下：

• 访问 Personal access tokens（在 GitHub 设置 > 开发者设置中）。
• 选择需要访问的仓库范围（公开、所有或指定）。
• 创建一个具有 repo 权限的令牌（“对私有仓库的完全控制”）。
• 复制生成的令牌。

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

🔧 技术细节

使用 Docker 构建镜像的命令如下：

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

📄 许可证

此 MCP 服务器根据 MIT 许可证分发。这意味着您可以自由使用、修改和分享该软件，但需在重新分发时包含许可证文件。更多细节请参考 MIT License。