Skip to content

GitHub MCP 服务器让 Copilot 在 Agent 模式下直接操作 GitHub——创建 Issue、列出 PR、查询仓库信息。VS Code 通过扩展市场安装,其他 IDE 通过 JSON 配置文件连接 https://api.githubcopilot.com/mcp/,支持 OAuth 和 PAT 两种认证方式。

配置 GitHub MCP 服务器:在 VS Code、JetBrains 等 IDE 中启用 GitHub 工具

前提条件

  • GitHub 账号(部分工具需要 Copilot 许可证)
  • 支持的 IDE 最新版本,并安装最新 Copilot 扩展
  • 组织用户:管理员需要在策略中开启"MCP servers in Copilot"

VS Code 安装方式(最简单)

  1. 打开扩展面板:Ctrl+Shift+X
  2. 搜索 @mcp github
  3. 安装 GitHub MCP server 扩展
  4. 信任扩展提示
  5. 通过命令面板 MCP: List Servers 确认配置成功

VS Code 会通过 OAuth 自动处理 GitHub 认证,无需手动配置 token。

Visual Studio 配置

在 Copilot Chat 中添加 MCP 服务器,选择 JSON 配置方式:

使用 OAuth(推荐,更安全):

json
{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

使用 Personal Access Token(更细粒度的权限控制):

json
{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_GITHUB_PAT"
      }
    }
  }
}

PAT 需要的权限:repoissuespull_requests 等(根据你需要使用的工具决定)。

JetBrains IDEs 配置

在 JetBrains MCP 配置文件(mcp.json)中添加:

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

使用 PAT 时添加 headers 字段(同 Visual Studio 配置)。

Xcode 配置

在 Copilot 扩展设置 → MCP 标签页中添加:

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

Eclipse 配置

通过 Copilot → MCP Settings 菜单添加相同的 JSON 配置。

企业 GitHub 环境

连接 GitHub Enterprise Server 或 GitHub Enterprise Cloud 需要额外配置,将 URL 替换为你的企业端点:

json
{
  "servers": {
    "github": {
      "url": "https://YOUR_ENTERPRISE_HOST/api/v3/mcp/"
    }
  }
}

常见问题

Q: GitHub MCP 服务器需要 Copilot 订阅吗?

A: GitHub MCP 服务器本身对所有 GitHub 用户开放,但某些 MCP 工具(如访问 Copilot 高级功能的工具)需要相应的 Copilot 订阅。

Q: PAT 和 OAuth 认证有什么实际区别?

A: OAuth 认证简单且权限与你的 GitHub 账号权限一致。PAT 允许你创建只有特定权限的 token,更适合安全要求高的场景,但需要定期续期(PAT 有过期时间)。

Q: 配置后 MCP 工具不出现怎么办?

A: 检查:① IDE 和 Copilot 扩展是否为最新版本;② MCP 配置 JSON 格式是否正确;③ 是否切换到 Agent 模式(非 Chat 模式);④ 重启 IDE 后再检查。