github-mcp-server

让 AI 客户端直接操作 GitHub 仓库与 Issue

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 5370 🐛 待处理 464 👀 关注 411
GitHub ↗
GitHub 星标 ★ 34566
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行部署

项目预览

github-mcp-server 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队github
定价模式🏷️完全免费
价格说明开源免费,需自行部署
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Go
技术栈/模型github,mcp,mcp-server
GitHub 星标★ 34566
上线时间2025-03-04 00:00:00
代码更新2026-11-18
仓库体积56.9 MB
本站数据更新2026-11-19
维护状态活跃
收录时间2026-11-19
浏览次数0

项目介绍

GitHub 官方开源的 MCP 服务器,用 Go 编写。它把 GitHub 平台能力封装成模型上下文协议(MCP)工具,让 Claude、Cursor、VS Code 等支持 MCP 的 AI 客户端直接读写仓库、管理 Issue 与 PR、检索代码、查看 Actions 状态,无需自己写 API 封装。核心能力包括:仓库与文件操作、Issue/PR 创建与评论、代码与提交搜索、用户与组织信息查询,并提供本地 stdio 与远程 HTTP 两种运行方式,支持 PAT 或 OAuth 鉴权,权限随令牌收敛。对智能体开发而言,它把 GitHub 从“人工操作界面”变成“可被 AI 调用的工具集”,适合构建自动修 Issue、代码审查、仓库巡检等 Agent 工作流。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-11-19 · 当前星标 ★ 34566

技术标签

使用教程

难度:入门 约 10 分钟 部署方式:Docker 7 步

环境要求

  • Docker(本地以容器方式运行 MCP 服务器)
  • 支持 MCP 的宿主应用,如 VS Code 1.101 及以上版本、Cursor、Claude Desktop、Windsurf 等
  • GitHub 账号,以及一个权限范围合适的 Personal Access Token(或使用 OAuth 登录)
  • 使用 Docker + OAuth 登录时,需把 127.0.0.1:8085 回调端口映射到宿主机

安装与启动步骤

  1. 1创建访问令牌

    在 GitHub 账号设置里生成 Personal Access Token,并只勾选实际需要的仓库、Issue、PR 权限;权限范围随令牌自动收敛。

  2. 2拉取官方镜像

    从 GitHub 容器仓库拉取官方镜像,无需本地编译 Go 代码。

    docker pull ghcr.io/github/github-mcp-server
  3. 3本地试跑容器

    以 stdio 模式启动容器,启动后等待宿主写入标准输入属于正常现象,按 Ctrl+C 退出。

    docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx ghcr.io/github/github-mcp-server
  4. 4配置 VS Code 连接

    在 .vscode/mcp.json 写远程 HTTP 配置,OAuth 方式无需自备令牌,首次使用会触发浏览器登录。

    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://api.githubcopilot.com/mcp/"
        }
      }
    }
  5. 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. 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. 7切换 Agent 模式

    在 Copilot Chat 输入框旁打开 Agent 模式,服务器会自动启动并注册工具。

关键配置

配置项必填说明示例
GITHUB_PERSONAL_ACCESS_TOKEN是GitHub 个人访问令牌,用于鉴权;设置后优先级高于 OAuthghp_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 模式下的启动命令,通常为 dockerdocker

如何确认成功

在 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

★ 30975 2026-08-09
claude-forge 开源

给 Claude Code 装上 11 个代理和 36 个命令,5 分钟搞定扩展。

oh-my-zsh for Claude Code — 16 agents, 35 commands, 32 skills, 21 safety hooks in o···

★ 881 2026-08-09
canonry 开源

监控并优化品牌在 AI 搜索中的可见度

Agent-first AI SEO (AEO/GEO) operating platform

★ 212 2026-08-09
claude-ops-inspector 开源

给 Claude 子代理代码做安全体检,防漏洞上线

Subagent Verification for Claude AI Code Networks 2026

★ 119 2026-08-09
Wireshark-MCP 开源

丢个 pcap 包,用大白话问 AI,拿 tshark 真实数据答你

Wireshark-MCP,Give your AI assistant a packet analyzer. Drop a .pcap file, ask ques···

★ 405 2026-10-18
ArcRift 开源

把网页 AI 聊天记忆同步到本地 IDE,让智能体不再失忆

Persistent local memory layer for AI. ArcRift uses a extension and a native MCP serv···

★ 249 2026-08-09
superlocalmemory 开源

本地优先 AI 记忆,数据不出门,检索率破 74%

Open-source governed, local-first memory control plane for AI agents and teams. arXi···

★ 278 2026-08-09
redel 开源

让AI智能体像细胞一样分裂,递归协作解决复杂任务

ReDel is a toolkit for researchers and developers to build, iterate on, and analyze ···

★ 96 2026-08-09
airunner 开源

本地离线跑 AI,画画聊天全搞定

Offline inference engine for art, real-time voice conversations, LLM powered chatbot···

★ 1318 2026-08-09