mcphub-operator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

MCPHub Operator

Repo-managed MCPHub control plane: workflow groups, bearer endpoints, optional compression, ChatGPT tunnel policy. Smart Routing stays off in tracked config.

NOT for: editing the agent-stack sync script, live skills-sync apply installs, or PostgreSQL/pgvector smart-routing setup (use maintainer OpenSpec + explicit user request).

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

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

Dispatch

调度

`$ARGUMENTS`	Action
(empty)	Show group picker summary, preflight command, and reference index
`preflight` / `doctor`	Run `bash scripts/preflight.sh` from skill dir; stop on `fail`
`groups` / `picker`	Load references/group-picker.md
`compression`	Load references/compression-opt-in.md
`tunnel`	Explain ChatGPT `tunnel` group-only policy + `.env.mcphub` tunnel vars
`cli`	Load references/cli-cheatsheet.md

`$ARGUMENTS`	操作
（空值）	显示组选择器摘要、预检命令及参考索引
`preflight` / `doctor`	从skill目录运行 `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 Contract

操作器约定

preflight

preflight

From repo root (or pass
```
--cwd
```
to bundled doctor), run:

bash

bash skills/mcphub-operator/scripts/preflight.sh

Stop when JSON
```
ok
```
is false or any check with
```
status: fail
```
touches settings parity, smart routing, or client profiles.
Treat
```
warn
```
as advisory (hub not running, bearer unset locally).

从代码库根目录运行（或向捆绑的doctor传递
```
--cwd
```
参数）：

bash

bash skills/mcphub-operator/scripts/preflight.sh

当JSON中的
```
ok
```
为false，或任何标记为
```
status: fail
```
的检查涉及设置一致性、智能路由或客户端配置文件时，停止操作。
将
```
warn
```
视为建议性提示（hub未运行、本地Bearer未设置）。

groups

groups

Default local harnesses attach harness
only, with per-server endpoints available but disabled by default.
Treat harness
as the smallest high-signal set for context-bloat control: Brave Search, DuckDuckGo Search, DDGS (metasearch/news), Context7, DeepWiki, llms.txt catalog (
```
llms-txt-explorer
```
```
list_websites
```
only), Fetch, and package metadata. Use
```
check_website
```
only via opt-in workflow groups. Prefer DDGS snippets; avoid
```
fetch_full_content
```
unless the user needs full pages.
Use daily
for routine opt-in expansion; use coding
, research
, review
, or release
for scoped agentic dev flows.

Escalate to capability groups (

web-search

web-read

docs

repo

browser

media

notebooks

data

design

productivity

accounts

references

) when the task needs that surface.

Use reasoning
only for hard problems; keep reasoning-lab
experimental.
Attach account-backed, live-browser (Chrome DevTools and Scrapling headless scrape sessions), heavy, or experimental groups only with explicit user intent.
Never attach tunnel
to local harness configs unless testing the remote consumer shape.

默认本地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
```
**组为实验性，需谨慎使用。
仅在用户明确意图下，关联基于账户的live-browser（Chrome DevTools和Scrapling无头抓取会话）、重型或实验性组。
除非测试远程消费者形态，否则切勿将**
```
tunnel
```
**组关联到本地harness配置。

compression

compression

Tracked

mcp_settings.json

keeps

toolResultCompression.enabled: false

Opt-in locally via
```
.env.mcphub
```
only after user approves; see compression reference.
Disable compression when debugging structured tool JSON or investigating truncation.

跟踪的

mcp_settings.json

文件中

toolResultCompression.enabled: false

保持默认关闭状态。

仅在用户批准后，通过本地
```
.env.mcphub
```
文件启用该功能；请参阅压缩参考文档。
调试结构化工具JSON或调查截断问题时，禁用压缩功能。

tunnel

tunnel

ChatGPT remote MCP uses tunnel
group only (
```
https://mcp.w4w.dev/mcp/tunnel
```
when tunnel enabled).
Do not widen ChatGPT to the global
```
/mcp
```
route or per-server endpoints without explicit user request.
Tunnel credentials stay in
```
.env.mcphub
```
/
```
~/.cloudflared/
```
— never commit.

ChatGPT远程MCP仅使用**
```
tunnel
```
**组（启用隧道时为
```
https://mcp.w4w.dev/mcp/tunnel
```
）。
未经用户明确请求，请勿将ChatGPT范围扩大到全局
```
/mcp
```
路由或各服务器端点。
隧道凭证存储在
```
.env.mcphub
```
/
```
~/.cloudflared/
```
中——切勿提交到代码库。

cli

cli

Prefer repo recipes:

just mcphub-generate

just mcphub-generate-check

just mcphub-validate

just mcphub-doctor

just mcphub-smoke

Use upstream MCPHub CLI for live hub inspection when the process is running; see CLI reference.

优先使用代码库中的命令：

just mcphub-generate

、

just mcphub-generate-check

、

just mcphub-validate

、

just mcphub-doctor

、

just mcphub-smoke

。

当hub进程运行时，使用上游MCPHub CLI进行实时hub检查；请参阅CLI参考文档。

Maintainer Loop

维护者流程

bash

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

Regenerate settings after editing

config/mcp-registry.json

groups or servers.

bash

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

编辑

config/mcp-registry.json

中的组或服务器后，重新生成设置。

References

参考文档

Group picker
CLI cheat sheet
Compression opt-in
Public maintainer doc:
```
docs/ai-tools/mcphub.md
```

组选择器
CLI速查表
压缩功能启用指南
公开维护者文档：
```
docs/ai-tools/mcphub.md
```

mcphub-operator

Original

Translation

MCPHub Operator

MCPHub Operator

Dispatch

调度

Operator Contract

操作器约定

`preflight`

`preflight`

`groups`

`groups`

`compression`

`compression`

`tunnel`

`tunnel`

`cli`

`cli`

Maintainer Loop

维护者流程

References

参考文档