Appearance
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 安装方式(最简单)
- 打开扩展面板:
Ctrl+Shift+X - 搜索
@mcp github - 安装 GitHub MCP server 扩展
- 信任扩展提示
- 通过命令面板
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 需要的权限:repo、issues、pull_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 后再检查。