项目简介

GitHub MCP 服务器是基于 Model Context Protocol (MCP) 构建的智能后端,专门为 AI 驱动开发团队设计。采用创新的代码优先架构,仅向客户端暴露单个工具,却内部集成112个GitHub操作工具,实现98%的令牌使用效率提升。

主要功能

  • 代码优先架构:仅暴露 'execute_code' 工具,内部通过 TypeScript 代码调用所有 GitHub 功能
  • 完整 GitHub 覆盖:支持仓库管理、PR操作、Issue管理、文件操作、工作流监控等
  • 智能工具发现:内置搜索、获取工具信息等功能
  • 双认证支持:支持 GitHub App 和 Personal Access Token 认证
  • 本地工作区集成:支持本地文件搜索、读取和编辑操作
  • 高性能连接池:97%延迟降低,后续调用从4000ms降至108ms
  • 安全沙箱执行:所有代码在 Deno 运行时中安全执行

安装步骤

  1. 确保系统已安装 Python 3.10+ 和 Deno 运行时
  2. 创建 GitHub Personal Access Token(需 repo 和 workflow 权限)
  3. 配置您的 MCP 客户端(如 Claude Desktop)

服务器配置

在您的 MCP 客户端配置文件中添加以下设置:

{
  "mcpServers": {
    "github-mcp": {
      "command": "python3",
      "args": ["-m", "github_mcp"],
      "env": {
        "GITHUB_TOKEN": "您的个人访问令牌"
  }
}

配置说明:

  • command:使用 python3 或 python 命令
  • args:指定运行 github_mcp 模块
  • GITHUB_TOKEN:必需的 GitHub 个人访问令牌

基本使用方法

  1. 在支持的 MCP 客户端中,您现在可以使用 'execute_code' 工具
  2. 在代码中调用 'callMCPTool()' 来执行具体的 GitHub 操作
  3. 使用 'searchTools()' 和 'getToolInfo()' 来发现和学习可用工具

高级功能:

  • 设置 'MCP_WORKSPACE_ROOT' 环境变量启用本地文件操作
  • 对于更高请求限制,可配置 GitHub App 认证

信息

分类

开发者工具