在 Cline 中接入 GitHub MCP Server远程流式 HTTP 与 Docker 本地部署完整配置指南【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server本文以 Cline运行于 VS Code 及各类兼容编辑器中的 AI 编程助手为宿主系统讲解 GitHub MCP Server 的两种接入方式直接连接 GitHub 官方托管的远程服务器https://api.githubcopilot.com/mcp/以及通过 Docker 运行本地服务器支持 OAuth 免 Token 登录或 Personal Access Token 认证。读完本文你将能够正确编写cline_mcp_settings.json、避开 transport 类型书写错误导致的 405 故障、按需裁剪工具集并理解底层认证逻辑与回调端口的实现原理。Cline 与 GitHub MCP Server 的接入方式总览Cline 是一个运行在 VS Code 兼容编辑器VS Code、Cursor、Windsurf 等中的开源 AI 编程助手。它通过 MCPModel Context Protocol标准协议与工具服务器通信而 GitHub MCP Server 正是 GitHub 官方提供的 MCP 服务端实现。从仓库的安装指南总览中的支持矩阵可以看到Cline 对两种部署形态均提供完整支持部署形态本地服务器远程服务器前置条件难度Cline✅ 支持✅ 支持PAT暂不支持 OAuthDocker 或 Go 源码构建、GitHub PAT简单远程服务器Remote无需本地安装任何运行时Cline 通过streamableHttp传输类型直连 GitHub 托管的 MCP 端点仅需一个 Personal Access TokenPAT作为 Bearer 认证头。本地服务器Local / Docker以commandargs方式启动docker run拉起的官方镜像ghcr.io/github/github-mcp-server可选 PAT 或 OAuth 两种认证方式。注意与 VS Code 等宿主不同Cline 接入远程服务器目前仅支持 PAT 认证不支持 OAuth 流程这一点从安装指南总览的 Support by Host Application 表格中Cline | ✅ | ✅ PAT ❌ No OAuth一栏可以确认。前提准备GitHub Personal Access Token无论采用远程还是本地 PAT 方式都需要先在 GitHub 账户的Settings → Developer settings → Personal access tokens页面创建一个 Token建议使用fine-grained PAT按需授予仓库Contents、Issues、Pull requests 等权限遵循最小权限原则经典 PATghp_前缀亦可使用但需注意仓库的作用域过滤文档中提到经典 PAT 会在启动时根据 token 的 scopes 自动过滤工具列表——你只能看到自己有权使用的工具而 OAuth远程服务器则通过 scope challenge 在需要时提示授权。方式一连接远程服务器Remote ServerCline 将 MCP 设置保存在cline_mcp_settings.json中。编辑方式点击编辑器侧边栏的 Cline 图标打开 Cline 面板右上角的菜单选择MCP Servers可以通过Remote Servers标签页添加远程服务器也可以点击Configure MCP Servers直接以 JSON 形式编辑。远程服务器最小配置{ mcpServers: { github: { url: https://api.githubcopilot.com/mcp/, type: streamableHttp, disabled: false, headers: { Authorization: Bearer YOUR_GITHUB_PAT }, autoApprove: [] } } }字段说明urlGitHub 官方远程 MCP 端点由仓库的远程服务器文档确认URL:https://api.githubcopilot.com/mcp/。该远程服务以本仓库代码为库构建并会定期同步最新版本它还额外提供了本地版本没有的工具例如调用 Copilot coding agent 的create_pull_request_with_copilot。type必须严格写作streamableHttpcamelCase无连字符。这是 Streamable HTTP 传输类型也是远程服务器唯一支持的传输方式。headers.AuthorizationBearer前缀 你的 PAT。autoApproveCline 中允许自动批准的工具列表默认为空数组所有工具调用都需要人工确认这是更安全的默认行为。通过 headers 定制工具集无需修改 URL直接在headers对象中追加服务端头即可按需裁剪工具。仓库的服务器配置指南提供了完整的配置参考表其中远程服务器对应如下请求头配置项远程服务器 Header说明工具集ToolsetsX-MCP-Toolsets逗号分隔如repos,issues单个工具ToolsX-MCP-Tools逗号分隔如get_file_contents,get_me排除工具X-MCP-Exclude-Tools排除优先于工具集与单个工具只读模式X-MCP-Readonly设为true时禁用所有写工具Lockdown 模式X-MCP-Lockdown过滤公共仓库中非 push 权限用户的内容例如只启用仓库与 Issue 相关工具并开启只读模式{ mcpServers: { github: { url: https://api.githubcopilot.com/mcp/, type: streamableHttp, headers: { Authorization: Bearer YOUR_GITHUB_PAT, X-MCP-Toolsets: repos,issues, X-MCP-Readonly: true }, autoApprove: [] } } }关于工具集的几个要点均来自远程服务器文档的 Optional Headers 章节未指定任何配置时服务器使用默认工具集context、issues、pull_requests、repos、usersX-MCP-Toolsets中的无效工具集名会被静默忽略不会导致服务器启动失败X-MCP-Tools中的无效工具名则会抛出错误并阻止服务器启动因此务必使用README工具列表中的准确名称只读模式是严格的安全过滤器优先级高于其他任何配置——即使显式请求了写工具也会被禁用例如issues工具集中的create_issue在只读模式下会被排除。关键警告transport 类型必须为streamableHttp重要传输类型必须写作streamableHttpcamelCase无连字符。如果写成streamable-http或完全省略typeCline 会回退到 SSE 传输而 GitHub MCP Server 不支持 SSE最终导致405错误。这是远程服务器接入中最常见的失败点排错章节会再次提及。方式二本地服务器Docker 部署本地部署无需远程服务且支持 OAuth 登录无 Token与 PAT 两种认证方式。操作步骤点击编辑器侧边栏的 Cline 图标或打开命令面板搜索 Cline点击 Cline 面板顶部的MCP Servers图标服务器堆叠图标再点击Configure MCP Servers打开cline_mcp_settings.json从下面两种配置中选择一种OAuth 方式无需 TokenPAT 方式需将YOUR_GITHUB_PAT替换为你的 GitHub Personal Access Token。方案 AOAuth 登录推荐免 Token使用 OAuth 代替 Token 登录。在 github.com 上官方镜像已经内置了应用凭据由构建过程通过-ldflags注入参见仓库 Dockerfile 中的internal/buildinfo.OAuthClientID/OAuthClientSecret你无需提供任何凭据——服务器首次使用时会打开浏览器登录且 Token仅保存在内存中不写入磁盘。在 Docker 中需要向回环地址发布一个固定的回调端口{ mcpServers: { 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 } } } }这段配置背后对应着仓库本地 OAuth 登录文档中描述的完整机制值得展开说明为什么需要固定端口8085容器无法访问宿主机的随机回环端口因此 Docker 下的 OAuth 需要一个固定的回调端口并通过-p发布进容器。端口8085与官方应用注册的回调 URL 一致。env中的GITHUB_OAUTH_CALLBACK_PORT对应stdio命令的--oauth-callback-port标志该标志在 main.go 中定义为OAuth 回调服务器的固定本地端口默认随机端口通过 Docker 映射端口时需设置固定值。底层流程本地服务器优先使用authorization code flow with PKCE——在你机器上启动一个回环回调服务器打开 GitHub 授权页用 PKCE verifier 交换 Token。由于 GitHub 在 token 端点要求 client secret官方构建将 secret 内置进二进制在公开分发的客户端中它并非真正机密PKCE 才是安全关键——它将授权码绑定到本次登录拦截回调也无法在其他地方兑换。容器无法打开宿主浏览器授权 URL 会通过 MCP 客户端的 URL elicitation保持 URL 不进入模型上下文或工具响应消息的方式送达。两个必须知晓的安全属性来自 docs/oauth-login.md 的 Docker 章节只发布到回环地址必须使用-p 127.0.0.1:8085:8085而不是-p 8085:8085。容器内回调必然监听所有接口普通发布会把授权码暴露到你的网络服务器在容器内绑定时会记录警告日志提醒这一点。端口被占用时直接报错退出有意设计使用固定端口时如果服务器无法绑定该端口被其他进程占用会报错停止而非静默回退到设备码流程——因为你未能占用的端口可能属于其他用户进程、正等着接收重定向。此时应释放端口或改用其他--oauth-callback-port。无浏览器环境的回退若没有可用浏览器或回调远程 shell、CI、未发布端口的容器服务器会回退到 GitHub 的device-code flow你会在终端看到类似Visit https://github.com/login/device and enter the code WDJB-MJHT to authorize the GitHub MCP Server.的提示在任何设备上完成授权后服务器轮询 GitHub 并继续。方案 BPersonal Access Token 认证如果设置 PAT它优先于 OAuthoauth-login.md 明确说明一旦设置GITHUB_PERSONAL_ACCESS_TOKEN服务器直接使用它并完全跳过 OAuth。main.go 的认证逻辑印证了这一点Token 为空、未配置 GitHub App 且无 OAuth client ID 时才会报错要求认证。{ 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 } } } }args中的-e GITHUB_PERSONAL_ACCESS_TOKEN不带等号表示从 Cline 注入的env取环境变量值避免 Token 直接出现在命令行中。关于镜像与本地二进制的一点说明仓库安装指南总览指出官方 Docker 镜像为ghcr.io/github/github-mcp-server旧的 npm 包modelcontextprotocol/server-github自 2025 年 4 月起不再受支持。如果不想用 Docker也可以直接从 Go 源码构建需 Go 1.24go build -o github-mcp-server cmd/github-mcp-server/main.go进阶本地服务器的更多配置项本地服务器stdio的配置对应命令行 flag 与环境变量。结合服务器配置指南的 Quick Reference 表配置项Flag环境变量工具集--toolsetsGITHUB_TOOLSETS单个工具--toolsGITHUB_TOOLS排除工具--exclude-toolsGITHUB_EXCLUDE_TOOLS只读模式--read-onlyGITHUB_READ_ONLYLockdown 模式--lockdown-modeGITHUB_LOCKDOWN_MODEInsiders 模式--insidersGITHUB_INSIDERS特性开关--features—服务器名称/标题—GITHUB_MCP_SERVER_NAME/GITHUB_MCP_SERVER_TITLE例如只想暴露 Pull Request 工具集并排除写操作工具可在 Docker args 中追加args: [ run, -i, --rm, -e, GITHUB_PERSONAL_ACCESS_TOKEN, ghcr.io/github/github-mcp-server, --toolsetspull_requests, --exclude-toolscreate_pull_request,merge_pull_request ]注意 main.go 中的实现细节由于 viper 对逗号分隔的环境变量GetStringSlice处理存在已知问题代码改用viper.IsSetUnmarshalKey解析工具集未设置时保持 nil 表示使用默认工具集。此外排除工具的优先级最高——即使工具集已启用或工具被--tools显式加入列在排除列表中的工具也始终被移除。故障排查Troubleshooting问题原因与解决方案远程服务器报 SSE 405 错误确保cline_mcp_settings.json中type为streamableHttpcamelCase无连字符。写成streamable-http或省略type都会让 Cline 回退到 SSE而本服务器不支持 SSE。认证失败Authentication failures确认你的 PAT 具备所需的作用域scopes。如需调整权限请在 GitHub 设置中编辑 Token 权限后重新生成并更新配置。Docker 相关问题确保 Docker Desktop 已安装并正在运行若使用 OAuth 且服务器报端口绑定失败请检查 8085 端口是否被占用并释放。进一步阅读安装指南总览包含 Cline 等全部宿主应用的支持矩阵、Docker/二进制/源码三种安装方法及通用安全最佳实践服务器配置指南工具集、只读、Lockdown、Insiders、MCP Apps 等完整配置参考与示例本地 OAuth 登录文档OAuth 流程原理、Docker 回调端口、设备码回退、自有应用与 GitHub Enterprise Server 支持远程服务器文档远程端点可用的全部工具集、可选 headers 与 URL 路径参数如/readonly、/x/{toolset}作用域过滤文档不同 Token 类型下工具可见性的过滤机制【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考