GitHub MCP Server 在 Copilot IDE 中的安装指南Visual Studio、JetBrains、Xcode 与 Eclipse 完整配置【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-serverGitHub MCP ServerGitHub 官方 MCP 服务器可将 AI 工具直接接入 GitHub 平台让 Copilot 以自然语言读取仓库与代码、管理 Issue 和 Pull Request、分析 CI/CD 流程。本文以 docs/installation-guides/install-other-copilot-ides.md 为主体系统讲解如何在 Visual Studio、JetBrains 系列 IDE、Xcode 与 Eclipse 四类 Copilot IDE 中完成远程/本地两种部署模式的安装配置读完你即可独立完成 OAuth 与 PAT 两种认证方式的接入并投入使用。前置要求在开始配置前请确认满足以下条件与文档 install-other-copilot-ides.md 列出的要求一致GitHub Copilot 许可证任何 Copilot 套餐Free、Pro、Pro、Business、Enterprise均可获得 Copilot 访问权限GitHub 账号个人 GitHub 账号即可组织/企业成员身份为可选项MCP Servers in Copilot 策略为员工分配 Copilot 席位的组织必须启用该策略才能让 Copilot for VS Code 与 Copilot Coding Agent 使用所有 MCP 访问其他 Copilot IDE 将在未来几个月内迁移到该策略下Editor Preview 策略在远程 GitHub MCP Server 处于公开预览期间为员工分配 Copilot 席位的组织需启用该策略以支持 OAuth 访问。说明目前所有 Copilot IDE 均支持远程 GitHub MCP Server。VS Code 支持 OAuth 认证而 Visual Studio、JetBrains 系列 IDE、Xcode 和 Eclipse 当前使用 PAT 认证OAuth 支持即将到来。远程服务器与本地服务器两种部署模式的选择安装 GitHub MCP Server 有两条路径二者基于同一代码库见 README.md维度远程服务器Remote推荐本地服务器Local托管位置由 GitHub 托管自动更新运行在你自己机器上Docker 容器或原生二进制本地设置无需任何本地安装需要 Docker 已安装并运行认证方式VS Code 支持 OAuthJetBrains/Xcode/Eclipse 目前使用 PAT支持 OAuth浏览器登录或 PAT端点https://api.githubcopilot.com/mcp/stdio 本地进程从源码角度印证本地服务器由 cmd/github-mcp-server/main.go 中的stdio子命令启动通过标准输入/输出使用 JSON-RPC 通信官方镜像ghcr.io/github/github-mcp-server的构建与入口定义在 Dockerfile默认CMD [stdio]镜像内暴露 8082 端口。认证方式的核心差异OAuth 与 PAT无论哪种部署模式本地服务器都遵循同一套认证优先级逻辑。从 main.go 可以看到设置了GITHUB_PERSONAL_ACCESS_TOKEN时PAT 优先于 OAuth服务器直接使用静态令牌并跳过 OAuth 流程未设置令牌时若提供了--oauth-client-id或官方构建默认使用内置的 OAuth 应用凭据则启用 OAuth 登录什么都不配置时会启动失败并提示authentication required: set GITHUB_PERSONAL_ACCESS_TOKEN, configure GitHub App auth, or pass --oauth-client-id to log in via OAuth。关于 OAuth 登录的完整机制授权码 PKCE 流程、回环回调服务器、设备码回退等请参阅 docs/oauth-login.md。Visual Studio 安装要求 Visual Studio 2022 17.14.9 或更高版本。远程服务器配置推荐远程 GitHub MCP Server 由 GitHub 托管提供自动更新无需本地设置。在解决方案目录或%USERPROFILE%目录下创建.mcp.json文件添加以下配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/ } } }保存文件等待 CodeLens 更新以提供对新服务器的认证入口激活它并选择用于认证的 GitHub 账号在 GitHub Copilot Chat 窗口中切换到Agent 模式激活 Chat 窗口中的工具选择器启用 github MCP 服务器中的一个或多个工具。本地服务器配置适合偏好本地运行的用户需要 Docker 已安装并运行。使用 OAuth 登录无需自己创建令牌在 github.com 上官方镜像已内置应用凭据无需提供任何内容——服务器首次使用时会在浏览器中打开登录页面令牌仅保存在内存中。在 Docker 中需要将固定回调端口发布到回环地址{ servers: { github: { type: stdio, 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 } } } }为什么需要固定回调端口 8085容器无法访问宿主机的随机回环端口。服务器启动时若未指定回调端口会默认使用随机端口在 Docker 中必须用--oauth-callback-port/GITHUB_OAUTH_CALLBACK_PORT固定端口并通过-p 127.0.0.1:8085:8085映射到本机回环地址对应 cmd/github-mcp-server/main.go 中定义的--oauth-callback-port标志。其中端口8085与官方应用注册的回调 URL 一致。关于原生二进制流程无需固定端口、无头/设备码回退、GitHub Enterprise 及自带 OAuth 或 GitHub App 的详细说明见 docs/oauth-login.md。改用 Personal Access Token 认证优先级高于 OAuth{ inputs: [ { id: github_pat, description: GitHub personal access token, type: promptString, password: true } ], servers: { github: { type: stdio, command: docker, args: [ run, -i, --rm, -e, GITHUB_PERSONAL_ACCESS_TOKEN, ghcr.io/github/github-mcp-server ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: ${input:github_pat} } } } }保存文件等待 CodeLens 更新以提供用户输入入口激活后粘贴你在 GitHub 令牌设置页面生成的 PAT在 Copilot Chat 中切换到 Agent 模式在工具选择器中启用 github MCP 服务器的工具。JetBrains IDEs 安装Agent 模式与 MCP 支持已面向 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 提供公开预览。远程服务器配置推荐注意JetBrains IDE 目前尚不支持远程 GitHub 服务器的 OAuth 认证必须使用 Personal Access TokenPAT。安装/更新 GitHub Copilot 插件点击状态栏中的 GitHub Copilot 图标→Edit Settings→Model Context Protocol→Configure添加配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/, requestInit: { headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } } }按Ctrl S或Command S保存或关闭mcp.json文件。配置应立即生效并重启所有已定义的 MCP 服务器如有需要可重启 IDE。本地服务器配置需要 Docker 已安装并运行。使用 OAuth 登录github.com 官方镜像内置凭据浏览器首登令牌仅存内存Docker 中发布固定回环回调端口{ 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 } } } }原生二进制流程无固定端口、无头/设备码回退、GitHub Enterprise 及自带 OAuth/GitHub App 见 docs/oauth-login.md。改用 PAT 认证优先级高于 OAuth{ servers: { github: { command: docker, args: [ run, -i, --rm, -e, GITHUB_PERSONAL_ACCESS_TOKEN, ghcr.io/github/github-mcp-server ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: YOUR_GITHUB_PAT } } } }Xcode 安装Agent 模式与 MCP 支持已面向 Xcode 提供公开预览。远程服务器配置推荐注意Xcode 目前尚不支持远程 GitHub 服务器的 OAuth 认证必须使用 PAT。安装/更新 GitHub Copilot for Xcode打开GitHub Copilot for Xcode 应用→Agent Mode→️ Tool Picker→Edit Config配置 MCP 服务器{ servers: { github: { url: https://api.githubcopilot.com/mcp/, requestInit: { headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } } }本地服务器配置需要 Docker 已安装并运行。OAuth 登录同上镜像内置凭据、内存令牌、固定回调端口发布到回环{ 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 } } } }相关细节见 docs/oauth-login.md。改用 PAT{ servers: { github: { command: docker, args: [ run, -i, --rm, -e, GITHUB_PERSONAL_ACCESS_TOKEN, ghcr.io/github/github-mcp-server ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: YOUR_GITHUB_PAT } } } }Eclipse 安装MCP 支持适用于 Eclipse 2024-03 及更高版本 最新版 GitHub Copilot 插件。远程服务器配置推荐注意Eclipse 目前尚不支持远程 GitHub 服务器的 OAuth 认证必须使用 PAT。从 Eclipse Marketplace 安装 GitHub Copilot 扩展点击GitHub Copilot 图标→Edit Preferences→MCP位于GitHub Copilot下添加 GitHub MCP 服务器配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/, requestInit: { headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } } }点击偏好设置对话框中的Apply and Close按钮配置自动生效。本地服务器配置需要 Docker 已安装并运行。OAuth 登录同上{ 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 } } } }详见 docs/oauth-login.md。改用 PAT{ servers: { github: { command: docker, args: [ run, -i, --rm, -e, GITHUB_PERSONAL_ACCESS_TOKEN, ghcr.io/github/github-mcp-server ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: YOUR_GITHUB_PAT } } } }GitHub Personal Access Token 说明使用 PAT 认证时请先在 GitHub 的个人访问令牌设置页面创建令牌并配置相应权限。官方建议遵循最小权限原则仅授予你的 AI 工具所需且你愿意赋予的权限。根据 README.md 与 docs/policies-and-governance.md 的最佳实践推荐使用细粒度 PATfine-grained而非经典令牌Classic。经典令牌作用域过宽且可在组织设置中整体禁用常用最小作用域repo仓库操作、read:packagesDocker 镜像拉取使用 Docker 时需要、read:org组织团队访问不要将令牌提交到版本控制可将令牌放入环境变量如export GITHUB_PERSONAL_ACCESS_TOKENyour_token_here或使用 IDE 的promptString输入机制引用如上文的${input:github_pat}定期轮换令牌不同项目/环境使用不同 PAT。配置完成后的使用完成上述任意一种配置后完全重启你的 IDE在 Copilot Chat 中打开Agent 模式尝试提问例如List recent issues in this repository此后 Copilot 即可访问 GitHub 数据并执行仓库操作。故障排查连接问题检查 GitHub PAT 权限以及 IDE 版本兼容性认证错误确认你的组织是否已为 Copilot 启用 MCP 策略工具不出现配置更改后重启 IDE并检查错误日志本地服务器问题确保 Docker 正在运行Docker 相关设置均依赖其运行镜像拉取失败若在拉取ghcr.io/github/github-mcp-server时出错可能是令牌过期尝试docker logout ghcr.io后重试。组织治理与策略补充在组织/企业环境中能否成功连接还取决于 docs/policies-and-governance.md 中描述的若干控制机制MCP Servers in Copilot 策略禁用时完全阻止受影响 Copilot 编辑器的所有 GitHub MCP Server 访问无论远程还是本地、无论 OAuth、PAT 还是 GitHub App。当前适用于 VS Code 和 Copilot Coding Agent其他 Copilot 编辑器将陆续迁移到该策略下Editor Preview 策略临时在远程服务器仍处于公开预览期间控制仍使用旧策略的编辑器能否通过 OAuth 连接远程服务器OAuth App / GitHub App 访问策略第三方主机应用通过 OAuth 连接时受 OAuth App 访问限制与 GitHub App 安装权限控制SSO 强制使用 OAuth 或 PAT 访问启用 SSO 的组织数据时令牌必须映射到最近的 SSO 登录。原理小结从配置到源码本文所有配置示例中的关键行为均可在仓库源码中找到对应实现GITHUB_PERSONAL_ACCESS_TOKEN与--oauth-client-id的优先级判定、以及GITHUB_OAUTH_CALLBACK_PORT的解析见 cmd/github-mcp-server/main.go 与 cmd/github-mcp-server/main.goOAuth 授权码 PKCE 流程、随机/固定回调端口、容器内无端口时回退设备码流程的实现见 internal/oauth/flow.go 与 internal/oauth/manager.go以及文档 docs/oauth-login.md官方 Docker 镜像的构建与默认stdio入口见 Dockerfile远程服务器可选的工具集、只读模式与 Insiders 模式等进阶配置见 docs/remote-server.md。完成上述配置后你就可以在 Visual Studio、JetBrains、Xcode 或 Eclipse 中让 GitHub Copilot 直接读写 Issue、PR 与仓库内容将日常开发工作流真正交给 Agent 模式驱动。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考