
github-mcp-server
让 AI 客户端直接操作 GitHub 仓库与 Issue
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 34566
技术标签
使用教程
环境要求
- Docker(本地以容器方式运行 MCP 服务器)
- 支持 MCP 的宿主应用,如 VS Code 1.101 及以上版本、Cursor、Claude Desktop、Windsurf 等
- GitHub 账号,以及一个权限范围合适的 Personal Access Token(或使用 OAuth 登录)
- 使用 Docker + OAuth 登录时,需把 127.0.0.1:8085 回调端口映射到宿主机
安装与启动步骤
-
1创建访问令牌
在 GitHub 账号设置里生成 Personal Access Token,并只勾选实际需要的仓库、Issue、PR 权限;权限范围随令牌自动收敛。
-
2拉取官方镜像
从 GitHub 容器仓库拉取官方镜像,无需本地编译 Go 代码。
docker pull ghcr.io/github/github-mcp-server -
3本地试跑容器
以 stdio 模式启动容器,启动后等待宿主写入标准输入属于正常现象,按 Ctrl+C 退出。
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx ghcr.io/github/github-mcp-server -
4配置 VS Code 连接
在 .vscode/mcp.json 写远程 HTTP 配置,OAuth 方式无需自备令牌,首次使用会触发浏览器登录。
{ "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } } } -
5改用 PAT 连接
若不想用 OAuth,可在同一配置里加 Authorization 头,并用 inputs 弹窗输入令牌,避免明文写死。
{ "servers": { "github": { "type": "http", "url": "https://api.githubcopilot.com/mcp/", "headers": { "Authorization": "Bearer ${input:github_mcp_pat}" } } }, "inputs": [ { "type": "promptString", "id": "github_mcp_pat", "description": "GitHub Personal Access Token", "password": true } ] } -
6容器方式接入宿主
其它 IDE 的 MCP 设置里填 docker 启动命令,令牌通过 env 传入,宿主启动时自动拉起容器。
{ "inputs": [ { "type": "promptString", "id": "github_token", "description": "GitHub Personal Access Token", "password": true } ], "servers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}" } } } } -
7切换 Agent 模式
在 Copilot Chat 输入框旁打开 Agent 模式,服务器会自动启动并注册工具。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
GITHUB_PERSONAL_ACCESS_TOKEN | 是 | GitHub 个人访问令牌,用于鉴权;设置后优先级高于 OAuth | ghp_xxxxxxxxxxxxxxxxxxxx |
GITHUB_OAUTH_CALLBACK_PORT | 否 | Docker 下 OAuth 登录的固定回调端口,需同时映射到回环地址 | 8085 |
servers.github.url | 否 | 远程 HTTP 模式的服务器地址 | https://api.githubcopilot.com/mcp/ |
servers.github.headers.Authorization | 否 | 远程模式下携带 PAT 的请求头 | Bearer ${input:github_mcp_pat} |
servers.github.command | 否 | 本地 stdio 模式下的启动命令,通常为 docker | docker |
如何确认成功
在 Agent 模式中让它查询某个仓库或 Issue,能返回真实 GitHub 数据即表示连接与鉴权成功。
常见问题
Q:用 PAT 还是 OAuth?
A:两者都行,PAT 会覆盖 OAuth。PAT 适合非交互场景,OAuth 首次登录走浏览器,令牌只保存在内存中。
Q:VS Code 提示不支持该服务器?
A:远程 MCP 与 OAuth 需要 VS Code 1.101 或更高版本,升级后重试。
Q:Docker 下 OAuth 登录回调失败?
A:容器需要把固定回调端口发布到回环地址,并同时设置 GITHUB_OAUTH_CALLBACK_PORT 环境变量。
Q:工具有些用不到怎么办?
A:可通过工具集(toolset)配置裁剪;未指定时使用默认工具集,具体写法见仓库远程服务器文档。
Q:容器启动后没有任何输出?
A:stdio 模式在等待宿主通过标准输入发送消息,属正常现象,由 MCP 宿主拉起即可。
注意事项
- 令牌权限越大 AI 可操作范围越大,建议按最小权限原则生成并定期轮换。
- 不要把含真实令牌的配置提交到公开仓库,推荐用宿主提供的输入弹窗方式注入。
- 不同宿主对远程 MCP 与 OAuth 的支持程度不同,具体以宿主自身文档为准。
- 库方式复用需使用 github.com/github/github-mcp-server/v2 前缀导入。
核心亮点
- GitHub 官方维护,工具定义与 API 行为跟平台同步,可信度高
- Go 单二进制部署,提供 stdio 与 HTTP 两种传输,接入主流 MCP 客户端成本低
- 工具粒度细,覆盖仓库、Issue、PR、搜索、Actions 等常用操作,适合搭 Agent 工作流
不足之处
- 工具数量多,上下文占用较大,需按场景裁剪工具集
- 远程部署涉及鉴权与权限配置,文档对多租户场景说明有限
适用场景
- AI 编程助手自动读取仓库代码并提交 PR 修复
- 根据 Issue 内容生成回复或分派标签的自动化机器人
- 在 IDE 内让模型检索提交历史与代码片段辅助排查
替代项目
mcp-github、github-mcp-server-archived、git-mcp
上一篇:mcp
下一篇:xiaohongshu-mcp
同类项目推荐
awesome-ai-agents
开源
一网打尽AI智能体项目,快速找到你需要的那个
A list of AI autonomous agents
claude-forge
开源
给 Claude Code 装上 11 个代理和 36 个命令,5 分钟搞定扩展。
oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in o···
canonry
开源
监控并优化品牌在 AI 搜索中的可见度
Agent-first AI SEO (AEO/GEO) operating platform
claude-ops-inspector
开源
给 Claude 子代理代码做安全体检,防漏洞上线
Subagent Verification for Claude AI Code Networks 2026
Wireshark-MCP
开源
丢个 pcap 包,用大白话问 AI,拿 tshark 真实数据答你
Wireshark-MCP,Give your AI assistant a packet analyzer. Drop a .pcap file, ask ques···
ArcRift
开源
把网页 AI 聊天记忆同步到本地 IDE,让智能体不再失忆
Persistent local memory layer for AI. ArcRift uses a extension and a native MCP serv···
superlocalmemory
开源
本地优先 AI 记忆,数据不出门,检索率破 74%
Open-source governed, local-first memory control plane for AI agents and teams. arXi···
redel
开源
让AI智能体像细胞一样分裂,递归协作解决复杂任务
ReDel is a toolkit for researchers and developers to build, iterate on, and analyze ···
airunner
开源
本地离线跑 AI,画画聊天全搞定
Offline inference engine for art, real-time voice conversations, LLM powered chatbot···