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

GitHub MCP Server是什么

GitHub MCP Server 是GitHub 官方推出的基于 Model Context Protocol (MCP) 的服务器工具，GitHub MCP Server能无缝集成 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 官方网站下载安装 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": "<YOUR_TOKEN>"
            }
        }
    }
}

• • • 将 <YOUR_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=<YOUR_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 等开发工具深度集成，支持从源代码构建，提升开发环境的自动化能力。