GitHub MCP Server 在 Copilot IDE 中的安裝指南Visual Studio、JetBrains、Xcode 與 Eclipse 完整配置【免費(fèi)下載鏈接】github-mcp-serverGitHubs official MCP Server項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-serverGitHub MCP ServerGitHub 官方 MCP 服務(wù)器可將 AI 工具直接接入 GitHub 平臺(tái)讓 Copilot 以自然語(yǔ)言讀取倉(cāng)庫(kù)與代碼、管理 Issue 和 Pull Request、分析 CI/CD 流程。本文以 docs/installation-guides/install-other-copilot-ides.md 為主體系統(tǒng)講解如何在 Visual Studio、JetBrains 系列 IDE、Xcode 與 Eclipse 四類 Copilot IDE 中完成遠(yuǎn)程/本地兩種部署模式的安裝配置讀完你即可獨(dú)立完成 OAuth 與 PAT 兩種認(rèn)證方式的接入并投入使用。前置要求在開(kāi)始配置前請(qǐng)確認(rèn)滿足以下條件與文檔 install-other-copilot-ides.md 列出的要求一致GitHub Copilot 許可證任何 Copilot 套餐Free、Pro、Pro、Business、Enterprise均可獲得 Copilot 訪問(wèn)權(quán)限GitHub 賬號(hào)個(gè)人 GitHub 賬號(hào)即可組織/企業(yè)成員身份為可選項(xiàng)MCP Servers in Copilot 策略為員工分配 Copilot 席位的組織必須啟用該策略才能讓 Copilot for VS Code 與 Copilot Coding Agent 使用所有 MCP 訪問(wèn)其他 Copilot IDE 將在未來(lái)幾個(gè)月內(nèi)遷移到該策略下Editor Preview 策略在遠(yuǎn)程 GitHub MCP Server 處于公開(kāi)預(yù)覽期間為員工分配 Copilot 席位的組織需啟用該策略以支持 OAuth 訪問(wèn)。說(shuō)明目前所有 Copilot IDE 均支持遠(yuǎn)程 GitHub MCP Server。VS Code 支持 OAuth 認(rèn)證而 Visual Studio、JetBrains 系列 IDE、Xcode 和 Eclipse 當(dāng)前使用 PAT 認(rèn)證OAuth 支持即將到來(lái)。遠(yuǎn)程服務(wù)器與本地服務(wù)器兩種部署模式的選擇安裝 GitHub MCP Server 有兩條路徑二者基于同一代碼庫(kù)見(jiàn) README.md維度遠(yuǎn)程服務(wù)器Remote推薦本地服務(wù)器Local托管位置由 GitHub 托管自動(dòng)更新運(yùn)行在你自己機(jī)器上Docker 容器或原生二進(jìn)制本地設(shè)置無(wú)需任何本地安裝需要 Docker 已安裝并運(yùn)行認(rèn)證方式VS Code 支持 OAuthJetBrains/Xcode/Eclipse 目前使用 PAT支持 OAuth瀏覽器登錄或 PAT端點(diǎn)https://api.githubcopilot.com/mcp/stdio 本地進(jìn)程從源碼角度印證本地服務(wù)器由 cmd/github-mcp-server/main.go 中的stdio子命令啟動(dòng)通過(guò)標(biāo)準(zhǔn)輸入/輸出使用 JSON-RPC 通信官方鏡像ghcr.io/github/github-mcp-server的構(gòu)建與入口定義在 Dockerfile默認(rèn)CMD [stdio]鏡像內(nèi)暴露 8082 端口。認(rèn)證方式的核心差異OAuth 與 PAT無(wú)論哪種部署模式本地服務(wù)器都遵循同一套認(rèn)證優(yōu)先級(jí)邏輯。從 main.go 可以看到設(shè)置了GITHUB_PERSONAL_ACCESS_TOKEN時(shí)PAT 優(yōu)先于 OAuth服務(wù)器直接使用靜態(tài)令牌并跳過(guò) OAuth 流程未設(shè)置令牌時(shí)若提供了--oauth-client-id或官方構(gòu)建默認(rèn)使用內(nèi)置的 OAuth 應(yīng)用憑據(jù)則啟用 OAuth 登錄什么都不配置時(shí)會(huì)啟動(dòng)失敗并提示authentication required: set GITHUB_PERSONAL_ACCESS_TOKEN, configure GitHub App auth, or pass --oauth-client-id to log in via OAuth。關(guān)于 OAuth 登錄的完整機(jī)制授權(quán)碼 PKCE 流程、回環(huán)回調(diào)服務(wù)器、設(shè)備碼回退等請(qǐng)參閱 docs/oauth-login.md。Visual Studio 安裝要求 Visual Studio 2022 17.14.9 或更高版本。遠(yuǎn)程服務(wù)器配置推薦遠(yuǎn)程 GitHub MCP Server 由 GitHub 托管提供自動(dòng)更新無(wú)需本地設(shè)置。在解決方案目錄或%USERPROFILE%目錄下創(chuàng)建.mcp.json文件添加以下配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/ } } }保存文件等待 CodeLens 更新以提供對(duì)新服務(wù)器的認(rèn)證入口激活它并選擇用于認(rèn)證的 GitHub 賬號(hào)在 GitHub Copilot Chat 窗口中切換到Agent 模式激活 Chat 窗口中的工具選擇器啟用 github MCP 服務(wù)器中的一個(gè)或多個(gè)工具。本地服務(wù)器配置適合偏好本地運(yùn)行的用戶需要 Docker 已安裝并運(yùn)行。使用 OAuth 登錄無(wú)需自己創(chuàng)建令牌在 github.com 上官方鏡像已內(nèi)置應(yīng)用憑據(jù)無(wú)需提供任何內(nèi)容——服務(wù)器首次使用時(shí)會(huì)在瀏覽器中打開(kāi)登錄頁(yè)面令牌僅保存在內(nèi)存中。在 Docker 中需要將固定回調(diào)端口發(fā)布到回環(huán)地址{ 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 } } } }為什么需要固定回調(diào)端口 8085容器無(wú)法訪問(wèn)宿主機(jī)的隨機(jī)回環(huán)端口。服務(wù)器啟動(dòng)時(shí)若未指定回調(diào)端口會(huì)默認(rèn)使用隨機(jī)端口在 Docker 中必須用--oauth-callback-port/GITHUB_OAUTH_CALLBACK_PORT固定端口并通過(guò)-p 127.0.0.1:8085:8085映射到本機(jī)回環(huán)地址對(duì)應(yīng) cmd/github-mcp-server/main.go 中定義的--oauth-callback-port標(biāo)志。其中端口8085與官方應(yīng)用注冊(cè)的回調(diào) URL 一致。關(guān)于原生二進(jìn)制流程無(wú)需固定端口、無(wú)頭/設(shè)備碼回退、GitHub Enterprise 及自帶 OAuth 或 GitHub App 的詳細(xì)說(shuō)明見(jiàn) docs/oauth-login.md。改用 Personal Access Token 認(rèn)證優(yōu)先級(jí)高于 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 令牌設(shè)置頁(yè)面生成的 PAT在 Copilot Chat 中切換到 Agent 模式在工具選擇器中啟用 github MCP 服務(wù)器的工具。JetBrains IDEs 安裝Agent 模式與 MCP 支持已面向 IntelliJ IDEA、PyCharm、WebStorm 等 JetBrains IDE 提供公開(kāi)預(yù)覽。遠(yuǎn)程服務(wù)器配置推薦注意JetBrains IDE 目前尚不支持遠(yuǎn)程 GitHub 服務(wù)器的 OAuth 認(rèn)證必須使用 Personal Access TokenPAT。安裝/更新 GitHub Copilot 插件點(diǎn)擊狀態(tài)欄中的 GitHub Copilot 圖標(biāo)→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保存或關(guān)閉mcp.json文件。配置應(yīng)立即生效并重啟所有已定義的 MCP 服務(wù)器如有需要可重啟 IDE。本地服務(wù)器配置需要 Docker 已安裝并運(yùn)行。使用 OAuth 登錄github.com 官方鏡像內(nèi)置憑據(jù)瀏覽器首登令牌僅存內(nèi)存Docker 中發(fā)布固定回環(huán)回調(diào)端口{ 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 } } } }原生二進(jìn)制流程無(wú)固定端口、無(wú)頭/設(shè)備碼回退、GitHub Enterprise 及自帶 OAuth/GitHub App 見(jiàn) docs/oauth-login.md。改用 PAT 認(rèn)證優(yōu)先級(jí)高于 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 提供公開(kāi)預(yù)覽。遠(yuǎn)程服務(wù)器配置推薦注意Xcode 目前尚不支持遠(yuǎn)程 GitHub 服務(wù)器的 OAuth 認(rèn)證必須使用 PAT。安裝/更新 GitHub Copilot for Xcode打開(kāi)GitHub Copilot for Xcode 應(yīng)用→Agent Mode→? Tool Picker→Edit Config配置 MCP 服務(wù)器{ servers: { github: { url: https://api.githubcopilot.com/mcp/, requestInit: { headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } } }本地服務(wù)器配置需要 Docker 已安裝并運(yùn)行。OAuth 登錄同上鏡像內(nèi)置憑據(jù)、內(nèi)存令牌、固定回調(diào)端口發(fā)布到回環(huán){ 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 } } } }相關(guān)細(xì)節(jié)見(jiàn) 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 插件。遠(yuǎn)程服務(wù)器配置推薦注意Eclipse 目前尚不支持遠(yuǎn)程 GitHub 服務(wù)器的 OAuth 認(rèn)證必須使用 PAT。從 Eclipse Marketplace 安裝 GitHub Copilot 擴(kuò)展點(diǎn)擊GitHub Copilot 圖標(biāo)→Edit Preferences→MCP位于GitHub Copilot下添加 GitHub MCP 服務(wù)器配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/, requestInit: { headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } } }點(diǎn)擊偏好設(shè)置對(duì)話框中的Apply and Close按鈕配置自動(dòng)生效。本地服務(wù)器配置需要 Docker 已安裝并運(yùn)行。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 } } } }詳見(jiàn) 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 說(shuō)明使用 PAT 認(rèn)證時(shí)請(qǐng)先在 GitHub 的個(gè)人訪問(wèn)令牌設(shè)置頁(yè)面創(chuàng)建令牌并配置相應(yīng)權(quán)限。官方建議遵循最小權(quán)限原則僅授予你的 AI 工具所需且你愿意賦予的權(quán)限。根據(jù) README.md 與 docs/policies-and-governance.md 的最佳實(shí)踐推薦使用細(xì)粒度 PATfine-grained而非經(jīng)典令牌Classic。經(jīng)典令牌作用域過(guò)寬且可在組織設(shè)置中整體禁用常用最小作用域repo倉(cāng)庫(kù)操作、read:packagesDocker 鏡像拉取使用 Docker 時(shí)需要、read:org組織團(tuán)隊(duì)訪問(wèn)不要將令牌提交到版本控制可將令牌放入環(huán)境變量如export GITHUB_PERSONAL_ACCESS_TOKENyour_token_here或使用 IDE 的promptString輸入機(jī)制引用如上文的${input:github_pat}定期輪換令牌不同項(xiàng)目/環(huán)境使用不同 PAT。配置完成后的使用完成上述任意一種配置后完全重啟你的 IDE在 Copilot Chat 中打開(kāi)Agent 模式嘗試提問(wèn)例如List recent issues in this repository此后 Copilot 即可訪問(wèn) GitHub 數(shù)據(jù)并執(zhí)行倉(cāng)庫(kù)操作。故障排查連接問(wèn)題檢查 GitHub PAT 權(quán)限以及 IDE 版本兼容性認(rèn)證錯(cuò)誤確認(rèn)你的組織是否已為 Copilot 啟用 MCP 策略工具不出現(xiàn)配置更改后重啟 IDE并檢查錯(cuò)誤日志本地服務(wù)器問(wèn)題確保 Docker 正在運(yùn)行Docker 相關(guān)設(shè)置均依賴其運(yùn)行鏡像拉取失敗若在拉取ghcr.io/github/github-mcp-server時(shí)出錯(cuò)可能是令牌過(guò)期嘗試docker logout ghcr.io后重試。組織治理與策略補(bǔ)充在組織/企業(yè)環(huán)境中能否成功連接還取決于 docs/policies-and-governance.md 中描述的若干控制機(jī)制MCP Servers in Copilot 策略禁用時(shí)完全阻止受影響 Copilot 編輯器的所有 GitHub MCP Server 訪問(wèn)無(wú)論遠(yuǎn)程還是本地、無(wú)論 OAuth、PAT 還是 GitHub App。當(dāng)前適用于 VS Code 和 Copilot Coding Agent其他 Copilot 編輯器將陸續(xù)遷移到該策略下Editor Preview 策略臨時(shí)在遠(yuǎn)程服務(wù)器仍處于公開(kāi)預(yù)覽期間控制仍使用舊策略的編輯器能否通過(guò) OAuth 連接遠(yuǎn)程服務(wù)器OAuth App / GitHub App 訪問(wèn)策略第三方主機(jī)應(yīng)用通過(guò) OAuth 連接時(shí)受 OAuth App 訪問(wèn)限制與 GitHub App 安裝權(quán)限控制SSO 強(qiáng)制使用 OAuth 或 PAT 訪問(wèn)啟用 SSO 的組織數(shù)據(jù)時(shí)令牌必須映射到最近的 SSO 登錄。原理小結(jié)從配置到源碼本文所有配置示例中的關(guān)鍵行為均可在倉(cāng)庫(kù)源碼中找到對(duì)應(yīng)實(shí)現(xiàn)GITHUB_PERSONAL_ACCESS_TOKEN與--oauth-client-id的優(yōu)先級(jí)判定、以及GITHUB_OAUTH_CALLBACK_PORT的解析見(jiàn) cmd/github-mcp-server/main.go 與 cmd/github-mcp-server/main.goOAuth 授權(quán)碼 PKCE 流程、隨機(jī)/固定回調(diào)端口、容器內(nèi)無(wú)端口時(shí)回退設(shè)備碼流程的實(shí)現(xiàn)見(jiàn) internal/oauth/flow.go 與 internal/oauth/manager.go以及文檔 docs/oauth-login.md官方 Docker 鏡像的構(gòu)建與默認(rèn)stdio入口見(jiàn) Dockerfile遠(yuǎn)程服務(wù)器可選的工具集、只讀模式與 Insiders 模式等進(jìn)階配置見(jiàn) docs/remote-server.md。完成上述配置后你就可以在 Visual Studio、JetBrains、Xcode 或 Eclipse 中讓 GitHub Copilot 直接讀寫 Issue、PR 與倉(cāng)庫(kù)內(nèi)容將日常開(kāi)發(fā)工作流真正交給 Agent 模式驅(qū)動(dòng)?！久赓M(fèi)下載鏈接】github-mcp-serverGitHubs official MCP Server項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考