mcpField
M
mcphub-operator

mcphub-operator

github.com/wyattowalshエージェントワークフロー535 回インストール8 週間前に更新
リポジトリ

mcphub-operator について

mcphub-operator は、リポジトリ内の MCPHub 設定を運用するスキルです。メンテナーがワークフローグループを選び、設定を確認し、圧縮や ChatGPT トンネルの範囲を管理できます。

主な機能

  1. 01MCPHub ワークフローグループの選択
  2. 02設定の事前チェック
  3. 03圧縮のオプトイン方針
  4. 04ChatGPT トンネル制限の確認
  5. 05リポジトリの CLI レシピ

活用シーン

  1. 01ローカルハーネス用のサーバーグループ選定
  2. 02MCPHub 運用前の設定確認
  3. 03承認済み圧縮オプションの設定
  4. 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.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 コントロールプレーン:ワークフローグループ、ベアラーエンドポイント、オプションの圧縮、ChatGPT トンネルポリシー。追跡対象の設定では、Smart Routing はオフのままにします。

対象外: エージェントスタックの同期スクリプトの編集、skills-sync のライブ適用インストール、PostgreSQL/pgvector のスマートルーティング設定(メンテナーの OpenSpec とユーザーからの明示的な依頼を使用してください)。

ディスパッチ

$ARGUMENTSアクション
(空)グループピッカーの概要、事前チェックコマンド、リファレンス一覧を表示します
preflight / doctorスキルディレクトリから bash scripts/preflight.sh を実行します。fail で停止します
groups / pickerreferences/group-picker.md を読み込みます
compressionreferences/compression-opt-in.md を読み込みます
tunnelChatGPT の tunnel グループ限定ポリシーと .env.mcphub のトンネル変数について説明します
clireferences/cli-cheatsheet.md を読み込みます

オペレーター契約

preflight
  1. リポジトリのルートから(または同梱の doctor に --cwd を渡して)実行します。
bash skills/mcphub-operator/scripts/preflight.sh
  1. JSON の ok が false の場合、または設定の整合性、スマートルーティング、クライアントプロファイルに関わるチェックの status: fail がある場合は停止します。
  2. warn は参考情報として扱います(hub が実行されていない、ローカルでベアラーが未設定)。
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. 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 のグループまたはサーバーを編集した後は、設定を再生成してください。

リファレンス

コメント