mcphub-operator について
mcphub-operator は、リポジトリ内の MCPHub 設定を運用するスキルです。メンテナーがワークフローグループを選び、設定を確認し、圧縮や ChatGPT トンネルの範囲を管理できます。
主な機能
- 01MCPHub ワークフローグループの選択
- 02設定の事前チェック
- 03圧縮のオプトイン方針
- 04ChatGPT トンネル制限の確認
- 05リポジトリの CLI レシピ
活用シーン
- 01ローカルハーネス用のサーバーグループ選定
- 02MCPHub 運用前の設定確認
- 03承認済み圧縮オプションの設定
- 04ChatGPT トンネルのアクセス方針確認
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.jsonreferences/cli-cheatsheet.mdcompression-opt-in.mdgroup-picker.mdscripts/check.pydoctor.pypreflight.shscripts/asset_toolkit/validate_hooks.py詳細
MCPHub Operator
リポジトリで管理する MCPHub コントロールプレーン:ワークフローグループ、ベアラーエンドポイント、オプションの圧縮、ChatGPT トンネルポリシー。追跡対象の設定では、Smart Routing はオフのままにします。
対象外: エージェントスタックの同期スクリプトの編集、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 を読み込みます |
オペレーター契約
preflight
- リポジトリのルートから(または同梱の doctor に
--cwdを渡して)実行します。
bash skills/mcphub-operator/scripts/preflight.sh
- JSON の
okが false の場合、または設定の整合性、スマートルーティング、クライアントプロファイルに関わるチェックのstatus: failがある場合は停止します。 warnは参考情報として扱います(hub が実行されていない、ローカルでベアラーが未設定)。
groups
- デフォルトのローカルハーネスでは
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は実験用として扱います。- アカウント連携型、ライブブラウザー(Chrome DevTools と Scrapling のヘッドレススクレイピングセッション)、高負荷、または実験的なグループを接続するのは、ユーザーの明示的な意図がある場合のみにしてください。
- リモートコンシューマーの構成をテストする場合を除き、ローカルハーネスの設定に
tunnelを接続しないでください。
compression
- 追跡対象の
mcp_settings.jsonではtoolResultCompression.enabled: falseを維持します。 - ユーザーの承認を得た後に限り、
.env.mcphubでローカルにオプトインします。圧縮リファレンスを参照してください。 - 構造化されたツール JSON のデバッグや切り詰めの調査を行う際は、圧縮を無効にしてください。
tunnel
- 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 を使用してください。CLI リファレンスを参照してください。
メンテナーループ
just mcphub-generate
just mcphub-generate-check
just mcphub-validate
uv run python skills/mcphub-operator/scripts/check.py
config/mcp-registry.json のグループまたはサーバーを編集した後は、設定を再生成してください。
リファレンス
- グループピッカー
- CLI チートシート
- 圧縮のオプトイン
- 公開メンテナー向けドキュメント:
docs/ai-tools/mcphub.md
コメント
Markdown 対応