GitHub MCP Server

GitHub MCP Server – GitHub推出基于 MCP 的服务器工具

GitHub MCP Server 是 GitHub 官方推出的一款基于模型上下文协议（Model Context Protocol,MCP）的服务器工具。它能够与 GitHub API 无缝整合，为开发者提供先进的自动化和交互功能，帮助他们轻松实现自动化工作流。

GitHub MCP Server是什么

GitHub MCP Server 是 GitHub 官方发布的工具，基于模型上下文协议（MCP）构建，旨在为开发者提供高效的自动化和交互功能。通过与 GitHub API 的无缝集成，开发者能够轻松处理 GitHub 仓库中的问题、Pull Request，以及提取和分析仓库数据等。GitHub MCP Server 包含多个功能模块，如用户管理、问题管理、Pull Request 管理和仓库管理，旨在简化复杂的开发流程，让开发者能够专注于核心任务。

GitHub MCP Server的主要功能

问题管理：实现自动创建、更新和关闭 GitHub 问题，支持批量操作如批量添加标签或指派人员。
Pull Request 管理：自动合并 Pull Request，更新分支，添加评论和审查反馈。
仓库内容管理：推送文件、创建新分支、获取文件内容等操作。
搜索功能：允许快速搜索代码片段、GitHub 用户和仓库。
仓库内容获取：获取特定路径下文件或目录的内容，支持特定分支、标签或提交。
提交记录分析：获取某分支的提交历史，便于进行代码审查和版本管理。
智能代码审查：分析代码质量，自动生成审查意见。
自动化问题分类：根据问题内容智能分配标签或指派人员。
代码扫描警报：检测代码中潜在问题并生成警报。

如何使用GitHub MCP Server

安装前置条件：
- 安装 Docker：请访问 Docker 官方网站下载安装 Docker。
- 创建 GitHub 个人访问令牌：
  - 登录到 GitHub 账户。
  - 点击右上角头像，选择设置（Settings）。
  - 在左侧菜单中选择开发者设置（Developer settings），然后选择个人访问令牌（Personal access tokens）。
  - 点击生成新令牌（Generate new token），选择所需权限，生成令牌并保存。
配置环境：
- 在 VS Code 中使用：
  - 打开 VS Code。
  - 按 Ctrl + Shift + P，输入 Preferences: Open User Settings (JSON)，打开用户设置文件。
  - 将以下 JSON 配置添加到文件中：

{
    "mcp": {
        "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}"
                }
            }
        }
    }
}

- - 保存并关闭设置文件。
- 在 Claude Desktop 中使用：
  - 创建一个配置文件，例如 mcp.json，并添加以下内容：

{
    "mcpServers": {
        "github": {
            "command": "docker","args": [
                "run","-i","--rm","-e","GITHUB_PERSONAL_ACCESS_TOKEN","ghcr.io/github/github-mcp-server"
            ],"env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": ""
            }
        }
    }
}

- - 将替换为 GitHub 个人访问令牌。
- 从源代码安装：
  - 确保安装了 Go 语言环境。
  - 克隆 GitHub MCP Server 仓库：

git clone https://github.com/github/github-mcp-server.git

cd github-mcp-server
go build -o github-mcp-server ./cmd/github-mcp-server

- - 运行服务器：

GITHUB_PERSONAL_ACCESS_TOKEN= ./github-mcp-server stdio

运行服务器：无论是使用 Docker 还是从源代码构建，请确保设置了环境变量 GITHUB_PERSONAL_ACCESS_TOKEN。启动服务器后，您可以通过标准输入输出与开发工具（如 VS Code 或 Claude Desktop）进行交互。
使用 GitHub MCP Server 的功能：
- 自动化工作流：利用配置工具自动处理 GitHub 问题和 Pull Request。
- 数据提取与分析：使用搜索功能，快速定位代码片段、获取文件内容、分析提交记录等。
- AI 驱动工具：若工具支持 AI 功能，可以利用智能代码审查、自动化问题分类等功能。

GitHub MCP Server的项目地址

GitHub仓库：https://github.com/github/github-mcp-server

GitHub MCP Server的应用场景

自动化工作流管理：自动创建、更新和关闭 GitHub 问题（Issues），以及合并 Pull Request（PR），显著减少手动操作，提高项目管理效率。
智能代码审查：基于 AI 驱动的工具自动生成代码审查反馈，检测潜在问题并生成警报，提升代码质量。
数据提取与分析：迅速搜索代码片段、仓库和用户信息，获取文件内容和提交历史，便于快速定位资源和进行代码分析。
仓库内容管理：创建新仓库、复制（Fork）仓库，推送文件到指定分支，创建新分支，简化仓库管理流程。
开发工具集成：与 VS Code、Claude Desktop 等开发工具深度集成，支持从源代码构建，提升开发环境的自动化能力。

阅读原文