❤️ 如果你也关注 AI 的发展现状，且对 AI 应用开发感兴趣，我会每日分享大模型与 AI 领域的开源项目和应用，提供运行实例和实用教程，帮助你快速上手AI技术！
🥦 AI 在线答疑 -> 智能检索历史文章和开源项目 -> 丰富的 AI 工具库 -> 每日更新 -> 尽在微信公众号 -> 搜一搜：蚝油菜花 🥦
🎯 「GitHub重度用户看过来！这个开源神器让你告别重复操作，AI自动接管代码审查+问题管理」
大家好，我是蚝油菜花。你是否也经历过这些开发噩梦——
- 👉 手动处理几十个GitHub问题，标签和指派人点到手软
- 👉 代码审查时在PR间反复横跳，错过关键修改点
- 👉 想批量更新仓库文件，却要逐个提交修改...
今天要介绍的 GitHub MCP Server ，正在重新定义GitHub自动化！这个基于Model Context Protocol的黑科技：
- ✅ 全栈自动化：从问题管理到代码审查，覆盖GitHub全流程
- ✅ 智能代码扫描：自动检测潜在问题，生成专业审查意见
- ✅ 企业级扩展：支持私有化部署，金融/医疗场景也能安心用
已有团队用它1天处理完季度积压问题，开源项目靠它实现7×24小时无人值守审查——你的GitHub工作流，是时候注入「AI加速剂」了！
🚀 快速阅读
GitHub MCP Server是一个基于Model Context Protocol的服务器工具。
- 功能：支持自动化处理GitHub问题、Pull Request和仓库管理等操作。
- 技术：采用Docker容器化部署，通过GitHub API实现深度集成。
GitHub MCP Server 是什么
GitHub MCP Server是一个基于Model Context Protocol (MCP)的服务器工具，专为开发者设计，用于实现GitHub工作流的自动化。它通过标准化的协议与开发工具集成，提供统一的接口来操作GitHub资源。
该工具采用容器化设计，支持Docker快速部署，能够无缝对接VS Code等主流开发环境。其核心价值在于将复杂的GitHub API封装为简单的工具调用，显著降低自动化脚本的开发门槛。
GitHub MCP Server 的主要功能
- 问题管理：支持批量创建、更新和关闭GitHub问题，自动添加标签和指派人。
- Pull Request管理：提供自动合并、分支更新和智能代码审查功能。
- 仓库内容操作：支持文件推送、分支创建和内容获取等仓库管理操作。
- 代码扫描：自动检测代码质量问题，生成详细警报报告。
- 搜索功能：支持跨仓库搜索代码片段、用户和项目信息。
如何运行 GitHub MCP Server
GitHub MCP Server 是一个Model Context Protocol (MCP)服务器，提供了与 GitHub API 的无缝集成，使开发者和工具能够实现高级自动化和交互功能。
- Model Context Protocol (MCP)：https://modelcontextprotocol.io/introduction
用例
- 自动化 GitHub 工作流和流程。
- 从 GitHub 仓库中提取和分析数据。
- 构建与 GitHub 生态系统交互的 AI 驱动工具和应用程序。
前提条件
1. 安装 Docker
要在一个容器中运行服务器，你需要安装Docker。
- Docker：https://www.docker.com/
2. 创建 GitHub 个人访问令牌
创建一个GitHub 个人访问令牌。MCP 服务器可以使用许多 GitHub API，因此请启用你认为合适的权限（要了解更多关于访问令牌的信息，请查看文档）。
- 创建 GitHub 个人访问令牌：https://github.com/settings/personal-access-tokens/new
- 访问令牌文档：https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
安装
使用 VS Code
为了快速安装，可以使用此 README 顶部的一键安装按钮。
手动安装时，将以下 JSON 块添加到 VS Code 的用户设置（JSON）文件中。你可以通过按 Ctrl + Shift + P 并键入 Preferences: Open User Settings (JSON) 来完成此操作。
可选地，你可以在工作区中添加一个名为 .vscode/mcp.json 的文件。这将允许你与其他人共享配置。
注意：在
.vscode/mcp.json文件中不需要mcp键。
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "github_token",
"description": "GitHub 个人访问令牌",
"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}"
}
}
}
}
}
有关在 VS Code 的代理模式中使用 MCP 服务器工具的更多信息，请参阅agent mode documentation。
- agent mode documentation：https://code.visualstudio.com/docs/copilot/chat/mcp-servers
使用 Claude Desktop
{
"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_TOKEN>"
}
}
}
}
从源代码构建
如果你没有 Docker，可以使用 go 在 cmd/github-mcp-server 目录中构建二进制文件，并使用 github-mcp-server stdio 命令，同时设置 GITHUB_PERSONAL_ACCESS_TOKEN 环境变量为你自己的令牌。
GitHub 企业服务器
可以使用 --gh-host 标志和 GH_HOST 环境变量来设置 GitHub 企业服务器主机名。
国际化 / 覆盖描述
可以通过在二进制文件所在的同一目录中创建一个 github-mcp-server-config.json 文件来覆盖工具的描述。
该文件应包含一个 JSON 对象，键为工具名称，值为新的描述。例如：
{
"TOOL_ADD_ISSUE_COMMENT_DESCRIPTION": "替代描述",
"TOOL_CREATE_BRANCH_DESCRIPTION": "在 GitHub 仓库中创建一个新分支"
}
可以通过运行带有 --export-translations 标志的二进制文件来导出当前的翻译。
此标志将保留你所做的任何翻译/覆盖，并添加自上次导出以来二进制文件中添加的任何新翻译。
./github-mcp-server --export-translations
cat github-mcp-server-config.json
也可以使用环境变量来覆盖描述。环境变量的名称与 JSON 文件中的键相同，但前缀为 GITHUB_MCP_ 并且全部大写。
例如，要覆盖 TOOL_ADD_ISSUE_COMMENT_DESCRIPTION 工具，可以设置以下环境变量：
export GITHUB_MCP_TOOL_ADD_ISSUE_COMMENT_DESCRIPTION="替代描述"
工具
用户
- get_me - 获取经过身份验证的用户详细信息
- 不需要参数
问题
get_issue - 获取仓库中问题的内容
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）issue_number: 问题编号（数字，必填）
get_issue_comments - 获取 GitHub 问题的评论
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）issue_number: 问题编号（数字，必填）
create_issue - 在 GitHub 仓库中创建新问题
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）title: 问题标题（字符串，必填）body: 问题正文内容（字符串，可选）assignees: 分配给此问题的用户名（字符串数组，可选）labels: 应用于此问题的标签（字符串数组，可选）
add_issue_comment - 向问题添加评论
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）issue_number: 问题编号（数字，必填）body: 评论文本（字符串，必填）
list_issues - 列出并筛选仓库问题
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）state: 按状态筛选（'open', 'closed', 'all'）（字符串，可选）labels: 按标签筛选（字符串数组，可选）sort: 按字段排序（'created', 'updated', 'comments'）（字符串，可选）direction: 排序方向（'asc', 'desc'）（字符串，可选）since: 按日期筛选（ISO 8601 时间戳）（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
update_issue - 更新 GitHub 仓库中的现有问题
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）issue_number: 要更新的问题编号（数字，必填）title: 新标题（字符串，可选）body: 新描述（字符串，可选）state: 新状态（'open' 或 'closed'）（字符串，可选）labels: 新标签（字符串数组，可选）assignees: 新分配者（字符串数组，可选）milestone: 新里程碑编号（数字，可选）
search_issues - 搜索问题和拉取请求
query: 搜索查询（字符串，必填）sort: 排序字段（字符串，可选）order: 排序顺序（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
拉取请求
get_pull_request - 获取特定拉取请求的详细信息
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）
list_pull_requests - 列出并筛选仓库拉取请求
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）state: PR 状态（字符串，可选）sort: 排序字段（字符串，可选）direction: 排序方向（字符串，可选）perPage: 每页结果数（数字，可选）page: 页码（数字，可选）
merge_pull_request - 合并拉取请求
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）commit_title: 合并提交的标题（字符串，可选）commit_message: 合并提交的消息（字符串，可选）merge_method: 合并方法（字符串，可选）
get_pull_request_files - 获取拉取请求中更改的文件列表
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）
get_pull_request_status - 获取拉取请求的所有状态检查的组合状态
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）
update_pull_request_branch - 使用基础分支的最新更改更新拉取请求分支
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）expectedHeadSha: 拉取请求的 HEAD 引用的预期 SHA（字符串，可选）
get_pull_request_comments - 获取拉取请求的审查评论
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）
get_pull_request_reviews - 获取拉取请求的审查
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）
create_pull_request_review - 在拉取请求审查中创建审查
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 拉取请求编号（数字，必填）body: 审查评论文本（字符串，可选）event: 审查操作（'APPROVE', 'REQUEST_CHANGES', 'COMMENT'）（字符串，必填）commitId: 要审查的提交 SHA（字符串，可选）comments: 放置在拉取请求更改上的行特定评论对象数组（数组，可选）- 对于内联评论：提供
path,position（或line）和body - 对于多行评论：提供
path,start_line,line，可选的side/start_side和body
- 对于内联评论：提供
create_pull_request - 创建新拉取请求
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）title: PR 标题（字符串，必填）body: PR 描述（字符串，可选）head: 包含更改的分支（字符串，必填）base: 要合并到的分支（字符串，必填）draft: 创建为草稿 PR（布尔值，可选）maintainer_can_modify: 允许维护者编辑（布尔值，可选）
update_pull_request - 更新 GitHub 仓库中的现有拉取请求
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）pullNumber: 要更新的拉取请求编号（数字，必填）title: 新标题（字符串，可选）body: 新描述（字符串，可选）state: 新状态（'open' 或 'closed'）（字符串，可选）base: 新基础分支名称（字符串，可选）maintainer_can_modify: 允许维护者编辑（布尔值，可选）
仓库
create_or_update_file - 在仓库中创建或更新单个文件
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）path: 文件路径（字符串，必填）message: 提交消息（字符串，必填）content: 文件内容（字符串，必填）branch: 分支名称（字符串，可选）sha: 如果更新文件，则为文件的 SHA（字符串，可选）
push_files - 在单个提交中推送多个文件
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）branch: 要推送的分支（字符串，必填）files: 要推送的文件，每个文件具有路径和内容（数组，必填）message: 提交消息（字符串，必填）
search_repositories - 搜索 GitHub 仓库
query: 搜索查询（字符串，必填）sort: 排序字段（字符串，可选）order: 排序顺序（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
create_repository - 创建新的 GitHub 仓库
name: 仓库名称（字符串，必填）description: 仓库描述（字符串，可选）private: 仓库是否为私有（布尔值，可选）autoInit: 自动初始化带有 README（布尔值，可选）
get_file_contents - 获取文件或目录的内容
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）path: 文件路径（字符串，必填）ref: Git 引用（字符串，可选）
fork_repository - 分叉仓库
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）organization: 目标组织名称（字符串，可选）
create_branch - 创建新分支
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）branch: 新分支名称（字符串，必填）sha: 创建分支的 SHA（字符串，必填）
list_commits - 获取仓库分支的提交
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）sha: 分支名称、标签或提交 SHA（字符串，可选）path: 仅包含此文件路径的提交（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
搜索
search_code - 在 GitHub 仓库中搜索代码
query: 搜索查询（字符串，必填）sort: 排序字段（字符串，可选）order: 排序顺序（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
search_users - 搜索 GitHub 用户
query: 搜索查询（字符串，必填）sort: 排序字段（字符串，可选）order: 排序顺序（字符串，可选）page: 页码（数字，可选）perPage: 每页结果数（数字，可选）
代码扫描
get_code_scanning_alert - 获取代码扫描警报
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）alertNumber: 警报编号（数字，必填）
list_code_scanning_alerts - 列出仓库的代码扫描警报
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）ref: Git 引用（字符串，可选）state: 警报状态（字符串，可选）severity: 警报严重性（字符串，可选）
资源
仓库内容
- 获取仓库内容
检索特定路径下的仓库内容。 - 模板:
repo://{owner}/{repo}/contents{/path*} 参数:
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）path: 文件或目录路径（字符串，可选）
获取特定分支的仓库内容
检索特定路径下的特定分支的仓库内容。- 模板:
repo://{owner}/{repo}/refs/heads/{branch}/contents{/path*} 参数:
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）branch: 分支名称（字符串，必填）path: 文件或目录路径（字符串，可选）
获取特定提交的仓库内容
检索特定路径下的特定提交的仓库内容。- 模板:
repo://{owner}/{repo}/sha/{sha}/contents{/path*} 参数:
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）sha: 提交 SHA（字符串，必填）path: 文件或目录路径（字符串，可选）
获取特定标签的仓库内容
检索特定路径下的特定标签的仓库内容。- 模板:
repo://{owner}/{repo}/refs/tags/{tag}/contents{/path*} 参数:
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）tag: 标签名称（字符串，必填）path: 文件或目录路径（字符串，可选）
获取特定拉取请求的仓库内容
检索特定路径下的特定拉取请求的仓库内容。- 模板:
repo://{owner}/{repo}/refs/pull/{prNumber}/head/contents{/path*} - 参数:
owner: 仓库所有者（字符串，必填）repo: 仓库名称（字符串，必填）prNumber: 拉取请求编号（字符串，必填）path: 文件或目录路径（字符串，可选）
资源
❤️ 如果你也关注 AI 的发展现状，且对 AI 应用开发感兴趣，我会每日分享大模型与 AI 领域的开源项目和应用，提供运行实例和实用教程，帮助你快速上手AI技术！
🥦 AI 在线答疑 -> 智能检索历史文章和开源项目 -> 丰富的 AI 工具库 -> 每日更新 -> 尽在微信公众号 -> 搜一搜：蚝油菜花 🥦
