GitHub MCP 服务器指南

安装 Docker 并启动服务

下载镜像

docker pull mcp/github

启动服务

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=mYnGfGhp0c3oQ9cd8w5DZvxnWiawQjxOls -p 1234:1234 mcp/github

支持的 Git 命令

获取仓库信息

git ls-remote https://github.com/username/repo.git

创建新分支

git branch new-feature -f origin/main:main

提交更改

git push https://x-access-token:<TOKEN>@github.com/username/repo.git main

支持的 GitHub API 命令

获取用户信息

GET /users/{username}

获取仓库信息

GET /repos/{owner}/{repo}

创建新分支

POST /repos/{owner}/{repo}/branches

支持的代码搜索命令

按语言搜索

language:javascript

按仓库路径搜索

repo:owner/name

按文件路径搜索

path:app/src

详细文档

个人访问令牌设置

创建 GitHub 个人访问令牌：

• 登录 GitHub 账户，进入“开发者设置” > “个人访问令牌”
• 生成新令牌，并授予“repo”范围权限

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 build -t mcp/github -f src/github/Dockerfile .

许可证

本 MCP 服务器基于 MIT 许可证。这意味着您可以自由使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多细节请参阅项目存储库中的 LICENSE 文件。

以下是完整的 GitHub MCP 服务器指南翻译内容：

GitHub MCP 服务器功能

支持命令

• 仓库信息：获取仓库的提交、分支和标签信息。
• 代码搜索：支持语言过滤、路径限制和文件扩展名筛选。
• 问题管理：搜索开放或关闭的问题，按标签分类。
• 拉取请求：查看合并状态和检查结果。
• 评论与审查：获取代码评论和审查意见。

使用示例

搜索代码

q: "import express" language:typescript path:src/

搜索问题

q: "memory leak" is:issue is:open label:bug

搜索用户

q: "fullstack developer" location:London followers:>100

设置与配置

个人访问令牌

创建并配置个人访问令牌，确保具有适当的权限（如“repo”范围）。

集成到 Claude Desktop

在 claude_desktop_config.json 中添加 GitHub MCP 服务器配置。

建议贡献者

欢迎 fork 仓库并提交 Pull Request。如有任何问题，请在 Issues 中提出。

以上是所有内容的完整中文翻译，仅供参考使用。