GitHub MCP Server

这个 Agent 能做什么，适合哪些场景？

GitHub MCP Server 是 GitHub 提供的 MCP 服务，可让兼容的 AI 工具连接 GitHub 平台。它通过 github-mcp-server 命令、Docker 容器或 GitHub 托管的远程端点运行，并向 MCP 客户端提供工具、资源和提示。能力覆盖仓库与代码检索、Issues 和 Pull Requests、GitHub Actions、讨论、通知、团队信息及安全告警。可用工具集能通过配置限制，--read-only 模式会跳过写入工具。远程服务需要支持远程 MCP 的主机；本地部署需要 Docker 或从 Go 源码构建，并使用 OAuth 或 GitHub Personal Access Token 认证。

MCP 客户端连接远程 https://api.githubcopilot.com/mcp/ 端点，或启动本地 github-mcp-server；服务以 OAuth 或 GITHUB_PERSONAL_ACCESS_TOKEN 认证后调用 GitHub API。客户端可以查询仓库文件、目录和提交，管理 Issues、Pull Requests、讨论与 Gists，查看 Actions 工作流和运行记录，读取 Dependabot 与代码扫描告警，也可按启用工具执行写入或工作流触发操作。服务将结果作为 MCP 工具响应返回，并在支持的协议版本中为部分工具提供结构化输出。

1. 维护者希望在 AI 主机中搜索仓库文件、查看提交并梳理项目结构。
2. 项目团队希望用自然语言创建或更新 Issues、Pull Requests 和讨论评论。
3. CI 负责人需要检查 Actions 工作流运行、作业日志、构建失败和制品。
4. 安全团队需要查询 Dependabot、代码扫描或安全公告相关信息。
5. GitHub 管理员需要查看团队成员、组织信息、规则集或自定义属性。

如何安装或部署这个 Agent？

可使用 GitHub 托管的远程服务器，或自行运行本地版本。远程连接需要兼容的 MCP 主机；本地容器方式需要已安装并运行的 Docker。GitHub.com 上可通过浏览器 OAuth 登录，也可配置 PAT；使用 PAT 时，将其作为 GITHUB_PERSONAL_ACCESS_TOKEN 提供。

远程服务器的 VS Code 配置：

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

本地 Docker 配置示例：

{
  "mcp": {
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-p",
          "127.0.0.1:8085:8085",
          "-e",
          "GITHUB_OAUTH_CALLBACK_PORT",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_OAUTH_CALLBACK_PORT": "8085"
        }
      }
    }
  }
}

也可从检出目录构建 Go 二进制：

go build -o github-mcp-server ./cmd/github-mcp-server

如何使用这个 Agent？

将服务器配置加入支持 MCP 的主机，然后在主机中启动 GitHub 服务。VS Code 的远程方式要求 1.101 或更高版本；完成配置后，在 Copilot Chat 中切换到 Agent 模式。可用 GITHUB_TOOLSETS 或 --toolsets 控制工具集，也可用 GITHUB_TOOLS 或 --tools 指定工具；未指定时默认启用 context、repos、issues、pull_requests 和 users。

本地 PAT 认证配置示例：

{
  "mcp": {
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }
}

从源码构建后，可通过 github-mcp-server stdio 启动；按需提供 PAT 和工具集配置。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题