mcpField
M
mcphub-operator

mcphub-operator

github.com/wyattowalshAgent 工作流535 次安装8 周前更新
代码仓库

关于 mcphub-operator

mcphub-operator 是用于管理仓库内 MCPHub 配置的技能，帮助维护者选择工作流组、检查配置状态，并遵循压缩与 ChatGPT 隧道的范围策略。

主要功能

  1. 01选择 MCPHub 工作流组
  2. 02运行配置预检
  3. 03说明压缩启用策略
  4. 04规定 ChatGPT 隧道限制
  5. 05提供仓库 CLI 配方

适用场景

  1. 01为本地 harness 选择服务组
  2. 02操作 MCPHub 前检查设置
  3. 03配置经批准的压缩选项
  4. 04查看 ChatGPT 隧道访问策略

MCP 相关

该技能指导 MCPHub 的运维，包括选择 MCP 服务组以及管理 ChatGPT 远程 MCP 隧道策略。它本身不向 MCP 客户端提供工具。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/wyattowalsh/agents --skill mcphub-operator

安装后在 Claude Code 中输入/mcphub-operator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
evals.json
references/
cli-cheatsheet.md
compression-opt-in.md
group-picker.md
scripts/
check.py
doctor.py
preflight.sh
scripts/asset_toolkit/
validate_hooks.py

详细介绍

MCPHub Operator

由仓库管理的 MCPHub 控制平面：工作流组、Bearer 端点、可选压缩、ChatGPT 隧道策略。跟踪配置中的 Smart Routing 保持关闭。

**不适用于：**编辑 agent-stack 同步脚本、实时 skills-sync 应用安装，或 PostgreSQL/pgvector 智能路由设置（请使用维护者 OpenSpec，并明确征得用户请求）。

调度

$ARGUMENTS操作
(空)显示分组选择器摘要、预检命令和参考索引
preflight / doctor在技能目录中运行 bash scripts/preflight.sh；遇到 fail 即停止
groups / picker加载 references/group-picker.md
compression加载 references/compression-opt-in.md
tunnel说明 ChatGPT 仅限 tunnel 组的策略 + .env.mcphub 隧道变量
cli加载 references/cli-cheatsheet.md

Operator 约定

preflight
  1. 从仓库根目录运行（或向捆绑的 doctor 传入 --cwd）：
bash skills/mcphub-operator/scripts/preflight.sh
  1. 如果 JSON 中的 ok 为 false，或任何涉及设置一致性、智能路由或客户端配置的检查状态为 fail，则停止。
  2. 将 warn 视为提示（hub 未运行、本地未设置 Bearer）。
groups
  1. 默认本地测试环境仅附加 harness，每个服务的端点可用，但默认禁用。
  2. 将 harness 视为控制上下文膨胀的最小高信号集合：Brave Search、DuckDuckGo Search、DDGS（元搜索/新闻）、Context7、DeepWiki、llms.txt 目录（仅限 llms-txt-explorer 的 list_websites）、Fetch 和软件包元数据。仅通过选择加入的工作流组使用 check_website。优先使用 DDGS 摘录；除非用户需要完整页面，否则避免使用 fetch_full_content。
  3. 日常选择加入扩展使用 daily；范围明确的智能体开发流程使用 coding、research、review 或 release。
  4. 任务需要相应能力时，升级使用能力组（web-search、web-read、docs、repo、browser、media、notebooks、data、design、productivity、accounts、references）。
  5. 仅在处理难题时使用 reasoning；将 reasoning-lab 保持为实验性功能。
  6. 仅在用户明确提出需求时，才附加依赖账户、实时浏览器（Chrome DevTools 和 Scrapling 无头抓取会话）、重量级或实验性组。
  7. 除非要测试远程使用方的配置，否则绝不要将 tunnel 附加到本地测试环境配置。
compression
  1. 跟踪的 mcp_settings.json 保持 toolResultCompression.enabled: false。
  2. 只有在用户批准后，才通过 .env.mcphub 在本地选择启用；请参阅压缩参考文档。
  3. 调试结构化工具 JSON 或调查内容截断时，禁用压缩。
tunnel
  1. ChatGPT 远程 MCP 仅使用 tunnel 组（启用隧道时为 https://mcp.w4w.dev/mcp/tunnel）。
  2. 未经用户明确请求，不要将 ChatGPT 的范围扩大到全局 /mcp 路由或各服务器端点。
  3. 隧道凭据保留在 .env.mcphub / ~/.cloudflared/ 中，绝不要提交。
cli
  1. 优先使用仓库配方：just mcphub-generate、just mcphub-generate-check、just mcphub-validate、just mcphub-doctor、just mcphub-smoke。
  2. 进程运行时，使用上游 MCPHub CLI 检查实时 hub；请参阅 CLI 参考文档。

维护者工作流程

just mcphub-generate
just mcphub-generate-check
just mcphub-validate
uv run python skills/mcphub-operator/scripts/check.py

编辑 config/mcp-registry.json 中的组或服务器后，重新生成设置。

参考资料

评论

支持 Markdown