项目简介

GitHub MCP Server 是一个基于 Model Context Protocol 的服务器实现，专门为AI工具提供与GitHub平台的深度集成。它允许AI助手、代理和聊天机器人通过自然语言交互来访问和管理GitHub资源。

主要功能

代码仓库管理：浏览代码、搜索文件、分析提交记录、理解项目结构
Issue和PR自动化：创建、更新、管理问题和拉取请求
CI/CD智能监控：查看工作流运行状态、分析构建失败原因
代码安全分析：检查安全发现、审查Dependabot警报
团队协作：访问讨论、管理通知、分析团队活动
代码扫描：获取代码安全警报、分析安全漏洞
讨论管理：获取和管理GitHub Discussions
组织管理：搜索和管理GitHub组织
用户管理：获取用户信息、搜索用户
Gist管理：创建、更新和列出Gist
通知管理：查看和操作GitHub通知

安装步骤

远程服务器（推荐）

适用于支持远程MCP服务器的客户端（VS Code 1.101+、Claude Desktop、Cursor、Windsurf等）

本地服务器

使用Docker运行或从源代码构建：

Docker方式：

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN=<你的令牌> ghcr.io/github/github-mcp-server

服务器配置

MCP客户端需要配置以下信息来连接GitHub MCP服务器：

{
  "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",
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  }
}

基本使用方法

获取个人访问令牌：在GitHub设置中创建具有必要权限的PAT
配置MCP客户端：将上述JSON配置添加到你的MCP客户端设置中
启用工具：服务器支持按功能模块启用工具集，包括repos、issues、pull_requests、actions等
启用代理模式：在支持MCP的IDE中启用代理模式
自然语言交互：通过聊天界面使用自然语言命令GitHub操作

工具集配置

可通过环境变量或命令行参数指定要启用的工具集：

GITHUB_TOOLSETS="repos,issues,pull_requests,actions" ./github-mcp-server

服务器支持动态工具发现、只读模式、GitHub Enterprise Server等高级配置选项。

关键词