用途:通过 Rube MCP(Composio 的 GitHub 工具包)自动化 GitHub 仓库管理、议题跟踪、拉取请求流程、分支操作与 CI/CD。工具包文档见 composio.dev/toolkits/github。
前提条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用);通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 github 的有效连接;每次先调用 RUBE_SEARCH_TOOLS 获取最新工具 schema。
设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应;调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit github;若连接非 ACTIVE,按返回的授权链接完成 GitHub OAuth;确认状态为 ACTIVE 后再运行工作流。
主要能力:1)议题管理:列出仓库、列出议题、创建议题与评论、跨仓库搜索议题和 PR。2)拉取请求:查找与筛选 PR、获取详情与可合并状态、查看变更文件、创建 PR、发布评论、检查 CI 状态、合并 PR。3)仓库与分支:列出/创建仓库、获取仓库信息、更新设置、列出分支、基于 SHA 创建引用。4)代码与提交搜索:搜索代码与路径、按作者搜索提交、列出提交、获取提交与文件内容。5)CI/CD:列出工作流、获取工作流详情、手动触发 workflow_dispatch、检查 check runs、列出部署与部署状态。6)用户与权限:列出协作者、查询用户权限、查看与更新分支保护、添加协作者。
使用方式:按各工作流的工具序列调用,常用参数包括 owner、repo、title、body、labels、assignees、state、head、base、merge_method、ref、sha、q、workflow_id、inputs、branch、permission 等。列表接口使用 page/per_page 分页,per_page 最大 100,需迭代至返回结果少于 per_page。
限制与注意事项:GITHUB_LIST_REPOSITORY_ISSUES 同时返回议题和 PR,需检查 pull_request 字段区分;无 push 权限时 labels、assignees、milestones 会被静默丢弃;创建 PR 在 base/head 无效、相同或已合并时返回 422;合并可能因草稿、已关闭或分支保护被拒,合并前应确认可合并状态并检查 CI,且需用户明确确认;GITHUB_CREATE_A_REFERENCE 仅创建新引用,已存在时返回 422;代码搜索仅索引默认分支上小于 384KB 的文件,最多返回 1000 条结果;按作者搜索提交必须包含关键词,不能只用限定符;空仓库调用 GITHUB_LIST_COMMITS 返回 409;未保护分支的 GITHUB_GET_BRANCH_PROTECTION 返回 404,视为无保护规则;仓库删除不可逆且需管理员权限;触发工作流需配置 workflow_dispatch,inputs 最多 10 对且须匹配定义。破坏性操作(合并、删除)需用户明确确认。