GitHub 官方发布的 MCP 服务器，赋予 AI 助手直接与 GitHub 仓库、Issues、PRs 及 Actions 交互的能力，支持远程与本地 Docker 部署。
GitHub 官方实现的 Model Context Protocol (MCP) 服务器。该项目旨在将 GitHub 平台能力（Repo 管理、Issue/PR 自动化、CI/CD 监控、安全分析）标准化为 AI 模型可调用的工具集。
核心功能#
- Repository Management: 浏览和查询代码、搜索文件、分析提交、理解项目结构
- Issue & PR Automation: 创建、更新、管理 issues 和 pull requests，AI 辅助分类 bug、审查代码变更
- CI/CD & Workflow Intelligence: 监控 GitHub Actions 工作流运行、分析构建失败、管理发布
- Code Analysis: 检查安全发现、审查 Dependabot 警报、理解代码模式
- Team Collaboration: 访问讨论、管理通知、分析团队活动
部署模式#
- Remote GitHub MCP Server: GitHub 托管的远程服务器（推荐）
- Local GitHub MCP Server: 本地 Docker 或源码构建部署
工具集系统#
支持 20+ 工具集，包括：
context（推荐）：提供当前用户和 GitHub 上下文actions：GitHub Actions 工作流和 CI/CD 操作code_security：代码安全相关工具issues、pull_requests、repos：核心 GitHub 功能copilot、dependabot、discussions等高级功能
特殊模式#
- Read-Only Mode: 只读模式，防止修改操作
- Lockdown Mode: 限制公共仓库中非协作者内容的显示
- Insiders Mode: 早期访问新功能和实验性工具
- Dynamic Tool Discovery: 动态工具集发现（Beta）
快速开始#
Remote Server（VS Code 配置）#
{
"servers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
}
}
}
Local Docker 部署#
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> \
ghcr.io/github/github-mcp-server
从源码构建#
go build -o github-mcp-server ./cmd/github-mcp-server
GITHUB_PERSONAL_ACCESS_TOKEN=<your-token> ./github-mcp-server stdio
配置能力#
- 工具集配置:
--toolsets repos,issues,pull_requests,actions,code_security - 单个工具配置:
--tools get_file_contents,issue_read,create_pull_request - Read-Only 模式:
--read-only或GITHUB_READ_ONLY=1 - Insiders 模式:
--insiders或GITHUB_INSIDERS=true - GitHub Enterprise 支持: 通过
GITHUB_HOST环境变量配置
项目架构#
- 主要语言: Go（95.8%）
- 辅助语言: TypeScript（2.2%）、Shell（1.8%）
- 容器化: Docker 支持，镜像地址
ghcr.io/github/github-mcp-server - 架构模式: MCP (Model Context Protocol) 服务器实现