SuperAPI AI 工具集

github-repos-manager-mcp

GitHub Repos Manager MCP Server 是一个基于 Node.js 的模型上下文协议(MCP)服务器,允许 MCP 客户端(如 Claude Desktop、Roo Code、Cline、Cursor、Windsurf 等)使用 GitHub 个人访问令牌与 GitHub 仓库进行交互。它无需 Docker,通过直接 API 集成提供 89 个工具,覆盖仓库管理、议题跟踪、拉取请求、分支与提交、协作与用户管理、文件与内容管理、图片上传等完整工作流。支持基于令牌的简易设置、仓库访问控制、工具启用/禁用、默认仓库配置以及速率限制处理等特性,旨在简化 GitHub 自动化管理并提升性能与安全性。

访问官网

工具介绍

GitHub Repos Manager MCP Server 是一个综合性的模型上下文协议(MCP)服务器,使用 Node.js 构建,使 MCP 客户端(如 Claude Desktop、Roo Code、Cline、Cursor、Windsurf 等)能够通过 GitHub 个人访问令牌(PAT)与 GitHub 仓库交互。其核心设计理念是简化设置、提升效率并增强控制能力,无需 Docker,直接集成 GitHub API,提供 89 个工具以覆盖完整的 GitHub 工作流。

主要能力包括:

  • 仓库管理:智能列出仓库(按可见性过滤、排序)、获取详细信息、浏览文件和目录、全站搜索仓库、设置默认仓库。
  • 议题管理:创建、编辑、列出议题,管理状态、标签、指派人,支持图片上传嵌入、评论系统、锁定/解锁议题。
  • 拉取请求管理:创建、编辑 PR,获取详情,列出审查和文件变更,提交审查(批准/请求更改/评论)。
  • 分支与提交管理:列出分支、创建分支、查看提交历史(按日期、作者、分支过滤)、获取提交详情、比较任意两个提交/分支/标签。
  • 协作与用户管理:获取用户资料、管理仓库协作者权限、团队协作工具。
  • 文件与内容管理:创建、更新文件,上传本地文件(支持二进制)。
  • 高级功能:图片上传与嵌入、批量操作、灵活的令牌认证、智能错误处理。

使用方式:

  1. 准备 Node.js(版本 18 或更高)和 GitHub 个人访问令牌(至少需要 repo 权限,可选 user:read 或 user:email 以读取用户资料,read:org 访问组织信息)。
  2. 通过 npx 直接运行服务器(无需安装),或在本地克隆仓库并安装依赖后运行 server.cjs。
  3. 在 MCP 客户端配置中指定服务器路径和 GH_TOKEN 环境变量。服务器将自动启动。
  4. 可选配置:通过环境变量或命令行参数设置默认仓库(GH_DEFAULT_OWNER、GH_DEFAULT_REPO 或 --default-owner、--default-repo),或使用 set_default_repo 工具在对话中设置。
  5. 安全控制:使用 GH_ALLOWED_REPOS 或 --allowed-repos 限制可访问的仓库(格式为 owner/repo 或仅 owner);使用 GH_DISABLED_TOOLS 或 --disabled-tools 禁用特定工具;使用 GH_ALLOWED_TOOLS 或 --allowed-tools 仅允许特定工具(若同时设置,GH_ALLOWED_TOOLS 优先)。

适用场景:适用于需要自动化管理 GitHub 仓库的开发者和团队,尤其是希望通过 MCP 客户端以自然语言指令执行 GitHub 操作的工作流,如批量议题处理、PR 审查、代码提交、仓库监控等。

限制:需要 GitHub 个人访问令牌;部分操作受 GitHub API 速率限制;工具数量较多,可通过配置控制访问范围;未提及具体收费或价格信息。