用途:通过 GitHub 官方 MCP 服务器搜索和操作用户的 GitHub 仓库,使用已安装的 github CLI 完成授权、仓库安装与工具调用。
主要能力与用法:先运行 github status 验证 OAuth 与 MCP 连通性(成功仅代表 OAuth 与 MCP 连通,不代表安装或仓库访问权限)。若 OAuth 未连接,运行 github authorize-url 并展示返回的 connect_url,每位用户以各自 GitHub 身份通过共享 Connect 流程授权。授权后运行 github install-url(不带 --state)获取安装链接;若命令失败或未返回 install_url,应说明无法生成安装链接,不得虚构链接。确认授权后用 widget.create(kind: "list")展示返回的 install_url,仅一行,标题“Select repositories”,副标题“Choose which repositories Muse can access”,type 为 link,data.url 取自 install_url,image_url 使用 GitHub 官方图标。若 widget 不可用,则用 Markdown 链接并保证链接所在行其后有文字。
安装:账户所有者或组织管理员选择 Muse 可访问的仓库。已有安装时 GitHub 会打开设置且可能不跳回 Muse,需请用户配置后返回对话。完成后用已审核的读取工具验证所需仓库访问权限,不得仅凭 OAuth 状态或点击安装链接声称拥有私有仓库访问权。用户令牌同时受该用户访问权限和应用安装仓库选择限制,安装不要求重复 OAuth。
工具与限制:运行 github list-tools 查看工具目录和 schema。call-read-tool 限 Muse 已审核只读白名单,使用连接器读权限;call-tool 用于写入、新工具或未知工具,每次都需要审批。调用格式:github call-read-tool --name <reviewed-read-tool> --arguments-json '<json-object>';github call-tool --name <write-or-unknown-tool> --arguments-json '<json-object>'。GitHub App 用户令牌不使用经典 OAuth scope,因此没有诚实的 scope 升级流程;渐进访问来自安装时的仓库选择以及 Muse 独立的读/写控制。不得从 GitHub 实时目录推断读取安全性:二进制会拒绝未审核名称,新公布的工具在审核前保持可写。切勿在对话中请求 OAuth 令牌或应用凭据。仓库缺失时不要断开或重复 OAuth,先检查登录身份和安装的仓库选择,仅在认证需修复或 GitHub App 身份变更时重连。GitHub 使用固定的 Muse 自有 GitHub App 身份,需允许在目标账户安装,不要求 Marketplace 上架;验证阶段仅安装于一次性测试仓库,更广泛的生产发布仍受审核和组织显式安装限制。