GitHub MCP Server 安装完全指南让 AI 助手直接管理仓库、Issue 与 PR【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server你让 AI 修一个线上 bug它却读不到仓库里的代码。GitHub MCP Server 把 AI 客户端接到 GitHub 平台。它能读仓库、管 Issue 和 PR、看 Actions 结果全程自然语言驱动。30 秒速览它是什么GitHub 官方 MCP 服务器把 AI 工具接到 GitHub API。适合谁用 Copilot、Claude、Cursor、Gemini 等客户端管项目的开发者。准备什么一个 GitHub PAT本地跑还要装好 Docker。跑通能干嘛自然语言读代码、建 PR、查构建日志、看安全告警。它如何工作链路很短。你的 AI 客户端说人话MCP 协议把它翻译成工具调用。服务器再把调用转成 GitHub API 请求。结果原路返回给客户端。工具集就是「开哪些门」的开关。开多了占上下文开少了能力受限。先想清楚要管什么再选路。先选路再动手两条独立决策线。先定跑法再定认证。跑法远程还是本地维度远程服务器本地 Docker接入直连api.githubcopilot.com/mcp/拉ghcr.io/github/github-mcp-server镜像客户端需支持 Streamable HTTP任意支持本地 MCP 的宿主额外能力多出copilot_spaces、github_support_docs_search可自带 OAuth / GitHub App适用少维护、用云端数据不出本地、用 GHES认证OAuth 还是 PAT维度OAuth浏览器登录PAT个人访问令牌准备不建 token首次弹浏览器自建 PAT授对应权限存储容器内 token 仅存内存经GITHUB_PERSONAL_ACCESS_TOKEN注入优先级有 PAT 时 PAT 优先高于 OAuth适用普通 github.com 用户固定凭证、CI、GHES远程端多数宿主只认 PAT。本地端两者皆可。下面按客户端给最短路径。分平台实操主流 IDEVS Code目标Agent 模式里用自然语言调 GitHub。版本1.101或更高支持远程 MCP 与 OAuth。步骤编辑工作区.vscode/mcp.json写入下面配置改完存盘。验证切到 Copilot Chat 旁的 Agent 模式让它「列出我的仓库」。{ servers: { github: { type: http, url: https://api.githubcopilot.com/mcp/ } } }Cursor目标聊天/编辑器里调 GitHub 工具。版本v0.48.0才有 Streamable HTTP。步骤编辑全局~/.cursor/mcp.json把YOUR_GITHUB_PAT换成你的令牌。验证完全重启 Cursor进 设置 → Tools Integrations → MCP Tools 看绿点。{ mcpServers: { github: { url: https://api.githubcopilot.com/mcp/, headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } }Windsurf目标Cascade 里接 GitHub。版本最新版本地跑要 Docker 运行中。步骤点锤子图标打开~/.codeium/windsurf/mcp_config.json用serverUrl字段。验证MCP 工具栏出现「1 available MCP server」服务名旁有绿点。{ mcpServers: { github: { serverUrl: https://api.githubcopilot.com/mcp/, headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } }独立客户端Claude Desktop目标桌面端接 GitHub。版本最新 Claude Desktop Docker。步骤编辑配置文件macOS 为~/Library/Application Support/Claude/claude_desktop_config.json加下面 docker 段。验证重启后工具列表里能看到 GitHub 工具。{ mcpServers: { 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 } } } }命令行Claude Code目标终端里让 Claude Code 调 GitHub。版本2.1.1用add-json更老版本用add --transport http。步骤在终端不是 Claude Code 内运行下面命令改完重启 Claude Code。验证跑claude mcp list应列出 github。claude mcp add-json github {type:http,url:https://api.githubcopilot.com/mcp,headers:{Authorization:Bearer YOUR_GITHUB_PAT}}Gemini CLI目标Gemini 终端接 GitHub。版本最新 Gemini CLI。步骤先在~/.gemini/.env存GITHUB_MCP_PAT再改~/.gemini/settings.json。验证重启 CLI确认 MCP 服务器列表里有 github。{ mcpServers: { github: { httpUrl: https://api.githubcopilot.com/mcp/, headers: { Authorization: Bearer $GITHUB_MCP_PAT } } } }跑通之后工具集裁剪默认开五个工具集context、repos、issues、pull_requests、users。按需收能省上下文也帮模型选对工具。本地--toolsets或GITHUB_TOOLSETS。远程X-MCP-Toolsets头或/x/{toolset}路径。只开单个工具--tools/X-MCP-Tools。只要读权限--read-only或/readonly。按场景挑工具集比按字母表翻更快。日常协作context、repos、issues、pull_requests、gists、discussions、notifications、labels、users。CI 与安全actions、code_quality、code_security、dependabot、secret_protection、security_advisories、git。组织管理orgs、projects、stargazers、copilot、copilot_issue_intents。Docker 里传环境变量docker run -i --rm \ -e GITHUB_PERSONAL_ACCESS_TOKENtoken \ -e GITHUB_TOOLSETSrepos,issues,pull_requests \ ghcr.io/github/github-mcp-serverPAT 放哪里最安全存环境变量或.env别硬编码进配置。最小权限repo、read:packages、read:org。.env写进.gitignore防止误提交。不同项目用不同 PAT定期轮换。含令牌的配置文件收紧权限如chmod 600。日志与排查入口Claude Code输入/mcp看服务器状态。Claude DesktopmacOS 看~/Library/Logs/Claude/。Windsurf看~/.codeium/windsurf/logs/。查有哪些工具github-mcp-server tool-search issue。配方合集服务器配置指南。踩坑速查现象原因解决连不上 / 不启动宿主不支持 Streamable HTTP升 VS Code1.101、Cursorv0.48.0否则改本地 Docker认证 401PAT 缺repo或已过期重建 PAT授对应权限Docker 拉取报错ghcr.io 旧 token 失效跑docker logout ghcr.io后重拉工具不显示工具集被裁掉 / JSON 语法错核对--toolsets用 linter 校验 JSON远程 OAuth 无反应容器回调端口没暴露本地加-p 127.0.0.1:8085:8085与GITHUB_OAUTH_CALLBACK_PORT选对跑法和认证配好工具集把 PAT 收进环境变量。剩下的交给自然语言。深入看 安装指南索引、远程服务器文档 与 策略与治理。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考