SuperAPI AI 工具集

mcphub-operator

部署与运维

查看项目

更新于 10-16 02:32

技能介绍

用途:MCPHub Operator 是仓库托管的 MCPHub 控制面技能,用于操作 MCPHub 的分组、端点、压缩与 CLI,并执行 hub 预检、分组选择以及隧道与本地暴露的决策。它不负责 agent-stack 同步脚本编辑、实时 skills-sync 应用安装,也不负责 PostgreSQL/pgvector 智能路由配置(后者需维护者 OpenSpec 与用户明确请求)。

主要能力与用法:

  • 预检:从仓库根目录运行 bash skills/mcphub-operator/scripts/preflight.sh;当 JSON ok 为 false,或任何 status: fail 的检查涉及设置一致性、智能路由或客户端配置时停止。warn 视为提示(hub 未运行、本地未设置 bearer)。
  • 分组:默认本地 harness 仅附加 harness,按服务器端点可用但默认禁用。harness 是控制上下文膨胀的最小高信号集,包含 Brave Search、DuckDuckGo Search、DDGS、Context7、DeepWiki、llms.txt 目录(仅 llms-txt-explorer list_websites)、Fetch 与包元数据。check_website 仅通过可选工作流分组使用;优先 DDGS 摘要,避免 fetch_full_content。日常用 daily,限定开发流程用 coding、research、review、release;需要特定能力时升级到 web-search、web-read、docs、repo、browser、media、notebooks、data、design、productivity、accounts、references 等分组;reasoning 仅用于难题,reasoning-lab 保持实验性;账户型、实时浏览器、重型或实验性分组需用户明确意图;除非测试远程消费者形态,否则不要将 tunnel 附加到本地 harness 配置。
  • 压缩:跟踪的 mcp_settings.json 保持 toolResultCompression.enabled: false;仅在用户批准后通过 .env.mcphub 本地启用;调试结构化工具 JSON 或排查截断时禁用压缩。
  • 隧道:ChatGPT 远程 MCP 仅使用 tunnel 分组(启用隧道时为 https://mcp.w4w.dev/mcp/tunnel);未经用户明确请求,不要将 ChatGPT 扩展到全局 /mcp 路由或按服务器端点;隧道凭据保存在 .env.mcphub / ~/.cloudflared/,切勿提交。
  • CLI:优先使用仓库配方 just mcphub-generate、just mcphub-generate-check、just mcphub-validate、just mcphub-doctor、just mcphub-smoke;hub 进程运行时可用上游 MCPHub CLI 进行实时检查。

维护循环:just mcphub-generate、just mcphub-generate-check、just mcphub-validate、uv run python skills/mcphub-operator/scripts/check.py;编辑 config/mcp-registry.json 的分组或服务器后需重新生成设置。

限制:不适用于 agent-stack 同步脚本编辑、实时 skills-sync 应用安装或 PostgreSQL/pgvector 智能路由配置;这些需维护者 OpenSpec 与用户明确请求。