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,获取详情,列出审查和文件变更,提交审查(批准/请求更改/评论)。
- 分支与提交管理:列出分支、创建分支、查看提交历史(按日期、作者、分支过滤)、获取提交详情、比较任意两个提交/分支/标签。
- 协作与用户管理:获取用户资料、管理仓库协作者权限、团队协作工具。
- 文件与内容管理:创建、更新文件,上传本地文件(支持二进制)。
- 高级功能:图片上传与嵌入、批量操作、灵活的令牌认证、智能错误处理。
使用方式:
- 准备 Node.js(版本 18 或更高)和 GitHub 个人访问令牌(至少需要 repo 权限,可选 user:read 或 user:email 以读取用户资料,read:org 访问组织信息)。
- 通过 npx 直接运行服务器(无需安装),或在本地克隆仓库并安装依赖后运行 server.cjs。
- 在 MCP 客户端配置中指定服务器路径和 GH_TOKEN 环境变量。服务器将自动启动。
- 可选配置:通过环境变量或命令行参数设置默认仓库(GH_DEFAULT_OWNER、GH_DEFAULT_REPO 或 --default-owner、--default-repo),或使用 set_default_repo 工具在对话中设置。
- 安全控制:使用 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 速率限制;工具数量较多,可通过配置控制访问范围;未提及具体收费或价格信息。