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 為主體系統(tǒng)講解如何在 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 賬號即可組織/企業(yè)成員身份為可選項MCP Servers in Copilot 策略為員工分配 Copilot 席位的組織必須啟用該策略才能讓 Copilot for VS Code 與 Copilot Coding Agent 使用所有 MCP 訪問其他 Copilot IDE 將在未來幾個月內(nèi)遷移到該策略下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]鏡像內(nèi)暴露 8082 端口。認證方式的核心差異OAuth 與 PAT無論哪種部署模式本地服務器都遵循同一套認證優(yōu)先級邏輯。從 main.go 可以看到設置了GITHUB_PERSONAL_ACCESS_TOKEN時PAT 優(yōu)先于 OAuth服務器直接使用靜態(tài)令牌并跳過 OAuth 流程未設置令牌時若提供了--oauth-client-id或官方構建默認使用內(nèi)置的 OAuth 應用憑據(jù)則啟用 OAuth 登錄什么都不配置時會啟動失敗并提示authentication required: set GITHUB_PERSONAL_ACCESS_TOKEN, configure GitHub App auth, or pass --oauth-client-id to log in via OAuth。關于 OAuth 登錄的完整機制授權碼 PKCE 流程、回環(huán)回調(diào)服務器、設備碼回退等請參閱 docs/oauth-login.md。Visual Studio 安裝要求 Visual Studio 2022 17.14.9 或更高版本。遠程服務器配置推薦遠程 GitHub MCP Server 由 GitHub 托管提供自動更新無需本地設置。在解決方案目錄或%USERPROFILE%目錄下創(chuàng)建.mcp.json文件添加以下配置{ servers: { github: { url: https://api.githubcopilot.com/mcp/ } } }保存文件等待 CodeLens 更新以提供對新服務器的認證入口激活它并選擇用于認證的 GitHub 賬號在 GitHub Copilot Chat 窗口中切換到Agent 模式激活 Chat 窗口中的工具選擇器啟用 github MCP 服務器中的一個或多個工具。本地服務器配置適合偏好本地運行的用戶需要 Docker 已安裝并運行。使用 OAuth 登錄無需自己創(chuàng)建令牌在 github.com 上官方鏡像已內(nèi)置應用憑據(jù)無需提供任何內(nèi)容——服務器首次使用時會在瀏覽器中打開登錄頁面令牌僅保存在內(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容器無法訪問宿主機的隨機回環(huán)端口。服務器啟動時若未指定回調(diào)端口會默認使用隨機端口在 Docker 中必須用--oauth-callback-port/GITHUB_OAUTH_CALLBACK_PORT固定端口并通過-p 127.0.0.1:8085:8085映射到本機回環(huán)地址對應 cmd/github-mcp-server/main.go 中定義的--oauth-callback-port標志。其中端口8085與官方應用注冊的回調(diào) URL 一致。關于原生二進制流程無需固定端口、無頭/設備碼回退、GitHub Enterprise 及自帶 OAuth 或 GitHub App 的詳細說明見 docs/oauth-login.md。改用 Personal Access Token 認證優(yōu)先級高于 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 插件點擊狀態(tài)欄中的 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 官方鏡像內(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 } } } }原生二進制流程無固定端口、無頭/設備碼回退、GitHub Enterprise 及自帶 OAuth/GitHub App 見 docs/oauth-login.md。改用 PAT 認證優(yōu)先級高于 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 登錄同上鏡像內(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 } } } }相關細節(jié)見 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 的個人訪問令牌設置頁面創(chuàng)建令牌并配置相應權限。官方建議遵循最小權限原則僅授予你的 AI 工具所需且你愿意賦予的權限。根據(jù) README.md 與 docs/policies-and-governance.md 的最佳實踐推薦使用細粒度 PATfine-grained而非經(jīng)典令牌Classic。經(jīng)典令牌作用域過寬且可在組織設置中整體禁用常用最小作用域repo倉庫操作、read:packagesDocker 鏡像拉取使用 Docker 時需要、read:org組織團隊訪問不要將令牌提交到版本控制可將令牌放入環(huán)境變量如export GITHUB_PERSONAL_ACCESS_TOKENyour_token_here或使用 IDE 的promptString輸入機制引用如上文的${input:github_pat}定期輪換令牌不同項目/環(huán)境使用不同 PAT。配置完成后的使用完成上述任意一種配置后完全重啟你的 IDE在 Copilot Chat 中打開Agent 模式嘗試提問例如List recent issues in this repository此后 Copilot 即可訪問 GitHub 數(shù)據(jù)并執(zhí)行倉庫操作。故障排查連接問題檢查 GitHub PAT 權限以及 IDE 版本兼容性認證錯誤確認你的組織是否已為 Copilot 啟用 MCP 策略工具不出現(xiàn)配置更改后重啟 IDE并檢查錯誤日志本地服務器問題確保 Docker 正在運行Docker 相關設置均依賴其運行鏡像拉取失敗若在拉取ghcr.io/github/github-mcp-server時出錯可能是令牌過期嘗試docker logout ghcr.io后重試。組織治理與策略補充在組織/企業(yè)環(huán)境中能否成功連接還取決于 docs/policies-and-governance.md 中描述的若干控制機制MCP Servers in Copilot 策略禁用時完全阻止受影響 Copilot 編輯器的所有 GitHub MCP Server 訪問無論遠程還是本地、無論 OAuth、PAT 還是 GitHub App。當前適用于 VS Code 和 Copilot Coding Agent其他 Copilot 編輯器將陸續(xù)遷移到該策略下Editor Preview 策略臨時在遠程服務器仍處于公開預覽期間控制仍使用舊策略的編輯器能否通過 OAuth 連接遠程服務器OAuth App / GitHub App 訪問策略第三方主機應用通過 OAuth 連接時受 OAuth App 訪問限制與 GitHub App 安裝權限控制SSO 強制使用 OAuth 或 PAT 訪問啟用 SSO 的組織數(shù)據(jù)時令牌必須映射到最近的 SSO 登錄。原理小結從配置到源碼本文所有配置示例中的關鍵行為均可在倉庫源碼中找到對應實現(xiàn)GITHUB_PERSONAL_ACCESS_TOKEN與--oauth-client-id的優(yōu)先級判定、以及GITHUB_OAUTH_CALLBACK_PORT的解析見 cmd/github-mcp-server/main.go 與 cmd/github-mcp-server/main.goOAuth 授權碼 PKCE 流程、隨機/固定回調(diào)端口、容器內(nèi)無端口時回退設備碼流程的實現(xiàn)見 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 與倉庫內(nèi)容將日常開發(fā)工作流真正交給 Agent 模式驅(qū)動?！久赓M下載鏈接】github-mcp-serverGitHubs official MCP Server項目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考