GitHub MCP Server 如何在 Cursor 中接入远程服务器并用 PAT 认证【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server如果你想在 Cursor 中调用 GitHub MCP Server 的工具查询仓库、Issue、Pull Request 等官方推荐的接入方式是使用 GitHub 托管的远程服务器而不是在本地跑 Docker。这条路径不需要安装 Docker 或构建 Go 二进制只需要两样东西一个最新版 Cursor远程 Streamable HTTP 支持要求 Cursor v0.48.0 及以上和一个带有合适 scopes 的 GitHub Personal Access TokenPAT。接入完成后你在 Cursor 的聊天或 composer 里就能直接使用 GitHub 相关工具。需要说明一点Cursor 虽然支持 OAuth 认证部分 MCP 服务器但 GitHub 托管的 MCP 服务器目前要求使用 PAT本文只覆盖 PAT 认证这条路径。准备条件Cursor IDE安装最新版远程服务器走 Streamable HTTP 传输Cursor 需为 v0.48.0 或更新版本。GitHub PAT在 GitHub 账户的 Personal Access Tokens 设置页创建一个 classic PATghp_前缀并授予你打算使用的操作所需的 scopes。PAT Scope Filtering 说明了 PAT 类型对可见工具的影响创建 token 前可以先看这一节。不需要Docker 或本地运行时——这是远程接入与本地接入的区别。本地 Docker 方案在 Cursor 安装指南 中有单独的配置示例属于另一条路径本文不展开。配置远程服务器编辑 Cursor 的全局 MCP 配置文件~/.cursor/mcp.json如果想只对某个项目生效可以在项目根目录使用.cursor/mcp.json写入{ mcpServers: { github: { url: https://api.githubcopilot.com/mcp/, headers: { Authorization: Bearer YOUR_GITHUB_PAT } } } }url固定为 GitHub 托管的远程服务器地址https://api.githubcopilot.com/mcp/。YOUR_GITHUB_PAT是占位符替换为你创建的实际 PAT 值。也可以走图形化流程在 Cursor 的 Tools Integrations MCP tools 中找到 github 项点击旁边的铅笔图标编辑把YOUR_GITHUB_PAT换成真实 token保存文件。保存配置后完全重启 Cursor不是重新加载窗口文档要求 complete restart。验证接入结果按 Cursor 安装指南 给出的验证顺序检查重启后打开 Settings → Tools Integrations → MCP Tools确认 github 条目显示绿点green dot在 chat/composer 中查看 Available Tools确认 GitHub 工具已列出直接测试输入 List my GitHub repositories能返回你的仓库列表即说明认证和工具调用都正常。PAT scopes 与可见工具远程服务器对 PAT 认证有一个重要行为它会根据 classic PAT 的 OAuth scopes 自动过滤工具。启动时服务器向 GitHub API 发一个轻量 HEAD 请求从X-OAuth-Scopes响应头读取 token 的 scopes缺少对应 scope 的工具会被直接隐藏。也就是说如果你的 PAT 只有repo和gist需要admin:org、project、notifications的工具不会出现。不同 token 类型的差异见 PAT Scope FilteringToken 类型工具可见性Classic PATghp_按 scopes 过滤缺少 scope 的工具被隐藏Fine-grained PATgithub_pat_不过滤全部工具可见由 GitHub API 在执行时强制权限GitHub App / 服务端 token不过滤权限按 app 配置执行注意 scopes 存在隐含包含关系repo隐含public_repo、security_eventsadmin:org隐含write:org再隐含read:org。另外只操作公开仓库的只读工具如get_file_contents始终可见即使 token 没有reposcope。配置 token 时可以用下面的命令确认它实际携带的 scopes$GITHUB_PERSONAL_ACCESS_TOKEN需先设为你的 PATcurl -sI -H Authorization: Bearer $GITHUB_PERSONAL_ACCESS_TOKEN \ https://api.github.com/user | grep -i x-oauth-scopes文档给出的示例输出x-oauth-scopes: delete_repo, gist, read:org, repo如果你之后在 GitHub 的 token 设置页调整了 scopes需要重启 MCP 服务器使变更生效。可选用 header 限制工具集默认配置下远程服务器使用 default toolsets。如果只想暴露部分能力可以在headers里加限制项配置方式与本地服务器的 flag/env 一一对应见 Server Configuration Guide 和 Remote Server{ mcpServers: { github: { url: https://api.githubcopilot.com/mcp/x/issues/readonly, headers: { Authorization: Bearer YOUR_GITHUB_PAT, X-MCP-Toolsets: repos,issues } } } }可用的控制手段X-MCP-Toolsets逗号分隔的工具集列表如repos,issuesX-MCP-Tools逗号分隔的单个工具列表无效工具名会导致服务器拒绝启动X-MCP-Readonly只启用读工具read-only 是优先于其他配置的严格过滤即使显式添加了写工具也会被禁用URL 路径修饰符在 URL 末尾加/readonly启用只读用/x/{toolset}指定单个工具集例如https://api.githubcopilot.com/mcp/x/issues/readonly。注意路径里的{toolset}只能写一个工具集要组合多个请用X-MCP-Toolsetsheader。这些配置均为可选不配置就使用默认工具集不影响基本的认证流程。排查常见问题遇到接入失败时按 Cursor 安装指南 的排查清单逐项核对Streamable HTTP 不生效确认 Cursor 版本是 v0.48.0 或更新旧版本不支持该传输认证失败核对 PAT 的 scopes 是否覆盖你要用的工具classic PAT 下 scopes 不足的工具会被隐藏而不是报错缺少预期工具时到 GitHub 的 token 设置页补 scopes然后重启连接错误检查防火墙和代理设置远程服务器依赖访问api.githubcopilot.com配置后 MCP 一直不加载确认是完全重启了 Cursor且mcp.json的 JSON 格式合法多余逗号、缺引号都会导致整个文件不生效;工具不出现回到 MCP Tools 页面确认服务器是绿点状态并在 Cursor 日志中查找 MCP 相关的错误。另外安装指南 README 的支持矩阵显示 Cursor 对远程服务器的支持形态是 ✅ PAT ❌ No OAuth即 OAuth 流程在 Cursor 中不可用遇到要求走 OAuth 的教程内容可以忽略以 PAT 配置为准。下一步接入验证通过后如果默认工具集不够用可以按 Server Configuration Guide 的工具集/单工具示例进一步收窄或扩展如果想了解远程服务器独有的工具例如create_pull_request_with_copilot见 Remote Server。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考