Skip to main content
Glama

MultiAgentMCP

English · 変更履歴 · セキュリティ · 開発・リリース

モデルを固定しないサブエージェント実行基盤(stdio MCP サーバー)。各社の公式CLIを正規のログインで呼び出す。

実行方式: OpenAI Codexの子エージェント制御(生成・状態・継続・待機・取消・終了)をNodeへ移植した子実行制御(src/child-control/、Apache-2.0、third_party/codex/)から、実行先ごとのアダプターを同じ契約で呼びます。親が許可済みモデル・Effort・作業場所を指定し、permission省略時はfull-access(信頼する子向け)。read-only/workspace-writeは従来のCLI標準制限(WindowsではMXC)を維持します。CLI実装・ホスト設定は信頼する設計で、CLIプロセス全体をVMへ閉じ込める機能ではありません。

敵対的な子には run_brokered_agent を使ってください。 こちらは認証を持つホストの推論専用サービスと、認証・通信のないMXC操作子を分離します。full-accessとは併用できず、read-only/workspace-writeの明示が必須です。

指定

実行

継続方式

省略 / full-access

Codex: codex app-server(danger-full-access・承認never・ephemeral)。Claude: --input-format stream-json(bypassPermissions・--no-session-persistence・空MCP)

会話ごとの子プロセスへ新しい入力だけを送る(mode=native)

read-only / workspace-write

従来の単発CLI+標準制限(Codex sandbox+MXC、Claude restricted+専用MXCシェル)

明示した履歴再送(mode=replay)

isolation: "brokered"

ホスト推論+認証なしMXC操作子

明示した履歴再送(mode=replay)

Node.js 24以上が必要です。Windowsで制限権限のコマンドを実行するにはMXC対応OSと対応Codex CLIが必要です。利用不能な場合、弱い隔離方式へ自動切替しません。他のOSで使える範囲は下の「macOS・Linux」節を参照。

  • codex-cli: Codex CLI(ChatGPT Plus のサインイン)。モデル一覧・Effort候補は codex debug models から実行時取得

  • claude-cli: Claude Code(Claude Pro のログイン)。CLIの stream-json 初期化応答から正式モデル名・モデル別Effortを取得。ヘルプの別名・実行履歴・API課金側の一覧は混ぜない

  • openai-compatible: OpenAI互換API(OpenAI / OpenRouter / Ollama 等)。config.json に追記するだけで追加

モデル名・Effortの選択肢はコードに書いていない。新モデルはCLI側の一覧に出た後、ユーザーの許可で利用可能になる。一覧に無いIDを指定すると一度再取得してから判定する。WindowsのCLI探索もPATH順を尊重するため、後順位の別インストールを優先しない。

一覧はログイン環境のCLIが提示する候補であり、ChatGPT/ClaudeのWeb画面の全モデルや、各モデルの実行成功・残り利用枠を保証するものではない。モデル取得時には生成依頼を送らない。

エージェントにインストールを頼む

Codex・Claude Code・OpenCodeなど、ターミナル操作ができるエージェントへ、このリポジトリのURLと一緒に次のように依頼してください。

このMCPをインストールして。READMEの導入手順に従って、クローン、依存関係の導入、MCP接続確認、導入済みのCodex・Claude Code・OpenCodeへの登録まで進めて。既存設定とモデル許可は保持して。

https://github.com/mofu1224/MultiAgentMCP

対象を限定したい場合は「Codexだけに登録して」「このフォルダに入れて」と付け加えられます。配布ファイルは不要で、クローンしたフォルダをそのまま使います。 導入先にソース・lock・試験・手順が揃うため、後から更新・検証できます。

CLIのログインや、どのモデル・Effortを許可するかの決定は利用者の判断が必要です。エージェントが認証情報を要求・コピーしたり、モデルを勝手に全許可したりする手順ではありません。

導入を依頼されたエージェント向け手順

利用者の依頼範囲と実行環境の権限に従い、次の順で進めてください。

  1. OS、git --version、node --version、npm --version、対象ホストのCLIを確認する。Node.jsは24以上。不足している場合は公式の導入方法を示し、必要な権限を超えてインストールしない。Codex / Claude Codeは利用するものだけ必要。

  2. 利用者指定の保存先、または利用者領域の永続的で書込み可能な場所へ、この依頼で渡されたリポジトリを git clone する。一時フォルダや他案件の中へ置かない。既存フォルダがあれば上書きせず、同じリポジトリかと未コミット変更の有無を確認する。

  3. クローン先を作業ディレクトリとして、順に実行する。

    npm ci --ignore-scripts
    npm test
    npm run check:release
    npm run verify:install -- .

    この検証は認証・モデル生成・モデル許可・ホスト登録を必要としない。失敗したら登録せず、原因を報告する。

  4. 登録対象を確認する。対象の指定が無ければ導入済みのCodex・Claude Code・OpenCode。登録前に node src/register-hosts.mjs --dry-run で変更予定を確認し、node src/register-hosts.mjs で登録する。単独ホストなら両コマンドに --host codex / --host claude / --host opencode を付ける。他のMCP・ホスト全体の設定は変更せず、multi-agent だけを更新する。未導入CLIはスキップする。

  5. 既存の config.json・allowlist.json・data/ と公式CLIの認証は保持する。初回はモデルが一つも許可されていない。node src/select-models.mjs --show で候補・許可状況を確認し、必要なら利用者に node src/select-models.mjs の選択を案内する。対話を自動操作する場合も、利用者が明示したモデル・Effortだけを設定する。

  6. クローン先、版、Nodeの起動元、登録したホスト、接続検証結果、ログイン・モデル許可の残作業を報告する。対象ホストのMCPだけを再接続できる場合は再接続し、できない場合は新しい接続から反映されることを伝える。ユーザーの他のセッションを強制終了しない。初回の実生成を無断で試さない。

接続後は親から list_providers → get_policy → list_models を呼び、対応機能と許可範囲を確認して start_agent を使う。

手動で導入する場合

git clone https://github.com/mofu1224/MultiAgentMCP.git
cd MultiAgentMCP

クローン先で上記の4つのコマンドを実行した後、node src/select-models.mjs と node src/register-hosts.mjs を実行する。Windowsでは select-models.cmd / register-hosts.cmd、macOSでは同名の .command も使える。

通常起動は npm start または node src/server.mjs。stdio MCPサーバーのため、単体起動では画面や対話メニューは出ない。許可リスト・設定・data/ は配置先に作られるので公開・配布しない。

注意: permission 省略時は full-access。信頼する子だけに使い、制限したい場合は明示する。モデル生成は各サービスの利用枠・料金に数えられる。本ソフトは各社の非公式連携ツールであり、サービスの利用条件に従う。

Related MCP server: cs-agent-mcp

ツール

ツール

内容

list_providers

プロバイダーの利用可否・機能・対応権限

list_models

実行時取得のモデル一覧(efforts・defaultEffort など)

run_agent

1件実行。provider model effort task role context files cwd permission timeout_ms json_schema

run_brokered_agent

敵対的な子向けの認証・推論分離。毎推論で許可を再検証して受付数に数え(上限は任意設定)、操作は認証なしMXCだけで実行

run_agents_parallel

複数件を並列実行

start_agent / get_agent / list_agents

非同期開始・進捗・結果取得(list_agents は会話・常駐セッションも返す)

wait_agents

指定ジョブ(省略時は未読の非同期完了通知)の終了待ち。timeoutは最小値未満を補正、最大値超過は拒否

send_agent_message

完了した会話へ追加入力。毎回モデル・Effort・権限を再検証

cancel_agent / close_conversation

取消要求(停止確認まで枠を保持)/会話の終了(native会話は子プロセス終了を待つ)

sandbox_status / run_isolated_code

隔離環境の準備確認/使い捨てJavaScript実行

get_run / usage_summary

実行記録・モデル別使用量(data/runs.jsonl。4MBを超えると新しい側の半分だけ残す)

get_policy

現在のポリシーと呼び出し連鎖の状態

モデル・Effortの決め方

  • 呼び出し元のエージェントが毎回決める。model と effort(モデルがEffort対応の場合)は必須で、未指定は拒否する。CLIの既定モデル(例: Fable)へ暗黙に流れることはない。

  • 使ってよい範囲はユーザーが決める。select-models.cmd(ダブルクリック)で、サブスク側から取得した一覧を見ながらモデルとEffortを番号で選ぶ。結果は allowlist.json に保存され、次の呼び出しから即反映。

  • list_models は許可済みモデルと allowedEfforts だけを返す。未確認の新モデルが出ると notice で知らせるが、ユーザーが許可するまで使えない。

  • 一覧から消えた許可済みモデルは選択画面で「廃止・改名の可能性」と表示する。

親エージェントからの実行

  1. list_providers で機能と対応権限を確認する。

  2. list_models の許可済みIDと allowedEfforts から、親がタスクごとに選ぶ。モデル情報取得に失敗した古い一覧は使わない。

  3. 通常は start_agent に provider・model・effort・cwd・task(必要なら permission)を渡し、バックグラウンドで実行する。Effort非対応が確認できたモデルだけ effort を省略できる。permission 省略はfull-access、ツール実行可能な子は cwd が必須。

  4. 親は別作業または wait_agents(job_ids 指定)で待ち、完了後に get_agent を一度取得する。status・最終結果・error・warnings と、必要な成果物・試験結果を確認する。短い同期処理には run_agent / run_agents_parallel も使える。モデル出力中の追加実行要求は自動で実行しない。

親の会話履歴は暗黙に共有せず、必要な情報を role・context・files で渡す。作業ファイルは共有されるため、並列編集では親が担当範囲や cwd を分ける。親による難易度別のモデル/Effort選択の目安は PARENT_GUIDE.md。

read-only はCodexのread-only sandbox、Claudeの読取ツール+読取専用MXCシェルに対応する。workspace-write はCodexのworkspace-write sandbox、Claudeのrestricted編集ツール+書込可能なMXCシェルに対応する。Claudeシェルは最小ランタイムと作業場所だけを許可し、通信を禁止する。両CLIの全ツールが同一の境界を持つわけではない。承認が必要な操作は自動的に権限を広げず拒否する。

非同期・会話継続・進捗

  • 敵対的な子を非同期実行する場合は start_agent に isolation: "brokered" を明示する。継続時も同じ指定が必須で、通常CLIへの緩和は拒否する。

  • start_agent は受付情報だけを即返す。wait_agents は終了したジョブのID・状態だけを返し、get_agent は既定でID・状態・最終結果だけを返す。進捗の反復取得はしない。

  • 障害調査時だけ get_agent の include_events: true でイベントと lastSequence を取得する。差分には after_event を併用する(直近300件まで保持)。include_events なしの after_event は入力矛盾として拒否する。

  • include_details: true を get_agent または同期実行リクエストに指定すると、使用量・modelUsed・permission・isolation・effective 等の実行メタデータを取得できる。イベントとは独立した指定。既定で除外するのは返却情報だけで、内部結果・会話履歴・制御は変更しない。

  • 成功した構造化出力は既定で structured のみ返し、同じ内容を output に二重掲載しない。非構造化出力は output。失敗時は生出力・エラー・警告を保持し、最終本文は切り詰めない。詳細指定では従来の完全な結果を返す。

  • 出力形式未指定時だけ、結論・成果物・検証結果・未確認事項または阻害要因を簡潔に報告し、途中の実況・試行履歴を省く指示を子へ追加する。output_instructions / json_schema 指定時はそれを優先する。これは報告指示であり、内容の正しさを保証する検証ではない。

  • 結果の conversationId を次の send_agent_message / run_agent の conversation_id に渡す。モデル・Effort・cwdは次ターンでも明示する。同一会話でprovider/cwd/権限/隔離方式を変更したり同時ターンを開始したりはできない。

  • native会話(full-access): 会話ごとに常駐する子プロセス(Codex app-server / Claude stream-json)へ新しい入力だけを送る。履歴は子プロセス内にだけあり、Codexは ephemeral=true、Claudeは --no-session-persistence でディスクへ会話を保存しない(実機で ~/.codex/sessions・~/.claude/projects に新規ファイルが増えないことを確認)。Codexは会話中のモデル/Effort変更に対応。Claudeはモデル変更に対応(制御要求 set_model、切替後のinit応答で照合)し、Effort変更は未対応(新しい会話が必要)。常駐数は policy.maxLiveSessions(既定6)。親が閉じ忘れても止まらないよう、上限に達したときは最も長く使われていない待機中の会話の子プロセスを解放して新しい会話を受け付け、policy.liveSessionIdleMs(既定30分)使われていない子プロセスも解放する(全て実行中なら上限エラー)。解放された会話は evicted と表示され、継続要求には理由付きで拒否する。保持ジョブ(policy.maxRetainedJobs、既定100)も終わったものから古い順に捨て、受付を止めない。開始時に実効モデル・権限を実行先の応答と照合し、不一致なら開始しない。中断に従わない子は強制終了し、その会話だけ継続不能にする(通常経路へ自動切替しない)。

  • replay会話(制限権限・brokered): 過去の実行プロンプト・添付スナップショット・応答をメモリから明示的に再送する。上限超過時は黙って履歴を切らず、新しい会話を要求する。

  • どちらもサーバー再起動後の復元はしない。

  • 同期実行は notify_progress: true とクライアントのprogress tokenが揃う場合だけMCP進捗通知を送る。非同期開始では通知しない。進捗はメタデータであり、思考本文の配信ではない。

  • 取消は要求受付と終了を区別し、get_agent / wait_agents で確定状態を確認する。共有枠は停止確認後に返す。完了会話は close_conversation で閉じる。メモリ保持は最大100ジョブ(policy.maxRetainedJobs、超えたら終わったものから古い順に破棄)。

  • ジョブ状態: accepted → queued → running → (cancelling) → succeeded / failed / cancelled / timeout、検証拒否は rejected。子の状態(agentStatus)はCodex由来の pending_init / running / interrupted / completed / errored / shutdown。

  • 利用ルールは PARENT_GUIDE.md をMCP初期化のinstructionsとしてホストへ自動提供する。

この返却方針は親のコンテキスト消費と途中仮説の混入を抑える。子自身の推論・ツール実行のトークン消費は残り、総トークン削減やハルシネーションの完全防止を保証しない。旧クライアントでメタデータやイベントが必要な場合は上記フラグを追加する。導入後はホストを再接続してツール定義とinstructionsを更新する。

安全装置

  • 呼び出し規則は src/control.mjs とRunnerで固定。モデル名やEffortの候補は固定しない。

  • 未指定・未許可・モデル情報取得失敗・Effort対応不明は拒否。自動のモデル切替・Effort除去・再試行はしない。モデルの生成本文に呼び出し指示があっても実行しない。

  • 子からの直接再帰は禁止。Codexはネイティブの追加エージェントを無効化、Claudeは使用ツールを限定し、継承MCP・カスタマイズを無効化する。追加要求はデータとして親へ返す。環境変数による再帰判定は補助であり、別CLIを起動する敵対的プロセスへの封じ込めではない。

  • 同じ dataDir のSQLiteで全MCPプロセスの同時実行枠(最大3)をトランザクション予約し、受付数を数える。受付回数の上限は既定で無い(2026-11-15 ユーザー判断)。config.json の policy.maxCallsPerRoot に正の整数を書いた場合だけ、配置全体の通算上限として適用する(別の会話ID・再起動ではリセットされない)。

  • 実行枠は所有プロセスのハートビート(15秒ごと)で生存を示す。所有プロセスが存在しない枠・120秒以上更新の無い枠は自動で回収するため、強制終了で枠が詰まって止まることはない。保存先を別々にした構成・別端末には集中制御が及ばない。

  • 待機後にユーザー許可を再検証。待機中キャンセルに対応。JSON Schema出力は返却前にも検証する。

  • full-access は既定(ローカル policy.allowedPermissions から外せば省略時も拒否され、自動で広げない)。full-accessの子に対する許可リスト・同時実行枠は信頼する子の運用制御であり、悪意ある子による別CLI起動等の迂回を防ぐものではない。厳密な保護が必要ならbrokeredを使う。ファイル転送は allowedCwdRoots の明示設定を必須とし、実体パスで範囲確認する。

  • ファイル操作・コード実行可能なプロバイダーは capabilities.executionControl: "provider-native" の実装が必要。未対応のものは拒否。

  • CLIの extraArgs は空配列以外を拒否し、指定したモデル・権限・追加委譲の制限を上書きさせない。Codexはユーザー設定・execpolicy rulesを読み込まず、Claudeは設定ソースを空にし、フック・自動記憶・claude.aiコネクタ・スラッシュコマンドを無効化する。safe-modeは明示した専用MCPまで無効化するため生成実行では使用しない。管理者ポリシーは引き続き適用される。以上は制限権限の単発経路の設定。full-accessのnative経路は標準環境で動かし、ユーザー設定(Codexのconfig、Claudeのsettings/フック/CLAUDE.md等)を読み込む。ただし再委譲と画面操作を防ぐため、Codexは agents.enabled=false に加え、ユーザーの config.toml に定義されたMCPサーバー(本MCP自身・画面操作系を含む)を個別に無効化し、プラグイン・アプリ・computer use・フック・通知も無効化する(app-serverに --ignore-user-config が無いため)。Claudeは空MCP(--strict-mcp-config)。子の環境変数で本MCPの再帰呼出しも拒否する。

外部コード隔離

run_isolated_code は code と任意の timeout_ms(最大60秒)を受け取る。Windows既定はMXCで、親の秘密環境変数を引き継がず、最小ランタイム+使い捨て作業場所だけを許可し、ネットワークを禁止する。

任意設定の sandbox.backend: "docker" も用意する。Dockerではホストディスク・認証・ネットワークを渡さず資源を制限し、イメージの自動pullは行わない。Docker未導入のためコンテナ実機検証は未実施であり、Windowsの検証済み既定方式はMXC。CLI自体の認証・推論通信はホストで維持し、CLI実装を信頼する。

認証・推論ブローカー方式

run_brokered_agent、または通常の実行ツールへ isolation: "brokered" を指定する。

親 → 許可/権限/共有予算の検証 → 推論専用ホスト
                               ↓ 固定スキーマの操作
                          認証なしMXC子 → 結果データ
                               ↓ 次の推論も予算検証
  • モデルが直接使えるホストツールはない。ホストで受理するモデル出力は execute(JavaScript)/finish の固定JSONのみ。操作コードはホストでevalせずMXC子にだけ渡す。

  • OpenAIモデルは既存OpenCodeのOpenAI接続とツール実行のない session.generate を使う。公式クライアントのサービス発見・認証をホスト内だけで使用する。同名モデルと同名variantがなければ拒否し、Codex CLIへフォールバックしない。推論用セッションは削除し、入力はセッション履歴に追加しない。

  • Claudeモデルは公式CLIを --safe-mode --tools ""・空MCPで推論専用にする。サブスクの正規認証はホストだけで利用し、モデルにホストツールを公開しない。

  • 最初の推論は受付時、次からの推論もSQLiteで一回ずつ受付数として数える(上限を設定した場合は毎推論で適用)。最大 max_steps(1〜8、既定8)。モデル/Effortの変更や子からの追加推論要求は入力データとして扱い、制御命令として解釈しない。各推論前と操作前に許可を再検証する。

  • MXC子は通信禁止、秘密環境変数を非継承。ホスト認証・本システムのコード/設定/許可リスト/状態DBを明示的に拒否する。作業場所が保護対象と重なる場合は推論前に拒否し、添付も作業場所内だけに限定する。workspace内の .env 等にも拒否ルールを追加する。

  • 返却の isolation は brokered-mxc。isolationEvidence にホストが記録した実行コード・SHA-256・実際の終了状態/出力を含める。証跡はメモリと返却結果だけで、永続ログに本文を保存しない。侵害試験は実行コード自体も既知の試験コードと照合する。

  • Windows MXC専用。未対応プロバイダー・モデル・OS・停止したブローカーでは拒否し、弱い方式に自動切替しない。推論サービスとOS/CLI実装は信頼する制御基盤であり、それ自体の侵害やカーネル脆弱性を防ぐ設計ではない。

状態管理

manage-state.cmd のダブルクリック、または node src/manage-state.mjs status で共有状態を確認できる。ローカル利用者の明示的な node src/manage-state.mjs reset-budget は、待機・実行枠がないときだけ受付数を0に戻す(上限を設定した場合の復旧用)。MCPには公開しない。所有者が消えた実行枠は status を含む各操作の時点で自動回収される(回収した数を reclaimed で表示)。

設定

config.example.json を config.json にコピーして編集(任意)。過去の onMissingModel / onMissingEffort / requireAllowlist / onInvalidEffort / onUnknownEffortSupport / onUnknownModel は無視し、緩和しない。get_policy の fixedControl が変更不能な規則を示す。

permission省略時はfull-accessへ正規化してから policy.allowedPermissions と実行先の対応を検証する(defaultPermission は表示用で、省略時の実効値は固定制御 CONTROL.defaultPermission)。brokeredでは省略を補完せず拒否する。MCPに許可リストを書き換えるツールは提供しない。ただし同じOSユーザーで動く信頼されたローカルクライアントに対し、ファイルへの直接変更まで防ぐものではない。

policy.allowedCwdRoots は空(既定)=子の作業場所の制限なし。full-accessの子はOSユーザー権限でどのフォルダでも編集できる。空のときは files による添付(ホストのファイルを読み込んでプロンプトへ渡す機能)は拒否されるため、子には cwd 内のファイルを自分で読ませる。

dataDir と allowedCwdRoots の相対パスは配置ルートから解決する。設定を分離する場合は MAMCP_CONFIG、許可リストは MAMCP_ALLOWLIST にファイルパスを指定する。APIキーの値は設定に書かず apiKeyEnv で環境変数名だけを指定する。この変数は子CLIへ渡さないが、full-accessでホスト上の秘密そのものを保護できるわけではない。

OpenAI互換API

テキスト生成専用。baseUrl と必要なら apiKeyEnv を設定する。APIがモデル別Effort候補を返さない場合は、確認済みの候補を modelEfforts: { "<model-id>": ["<effort>"] } または全モデル共通の efforts に設定する。Effortを送らないサービス・モデル群は effortParam: null とする(対応なし=空配列)。候補が不明なままなら実行を拒否する。GET /models の期限は既定15秒(listTimeoutMs)。HTTPエンドポイントは信頼するものだけを設定する。

更新・移動・削除

更新するときは対象MCPのジョブが終わっていることを確認して接続を停止し、クローン先で git status --short を確認する。変更があれば保持して判断し、無ければ git pull --ff-only → npm ci --ignore-scripts → npm test → npm run check:release → npm run verify:install -- . の順で検証して再接続する。認証・config.json・allowlist.json・data/ はコピーや初期化をしない。

配置やNodeの実行パスを移した場合は登録も更新する。get_policy の version・root で起動元を確認できる。削除するときは先に対象ホストの multi-agent 登録を解除し、必要なローカル設定を利用者の手元に保存したうえでクローン先を削除する。

ソースのクローンだけを導入経路とし、別の配布物・端末間コピー・専用の配布スクリプトは用意しない。npmレジストリへの公開は private: true で無効化している。開発者向けの確認は 開発・リリース手順 を参照。

登録例

register-hosts.cmd のダブルクリック、または node src/register-hosts.mjs でCodex・Claude Code・OpenCodeへユーザー単位で登録する。未導入のCLIはスキップし、導入済みのCLIが失敗した場合はエラーを返す。既存の multi-agent 登録は更新する。取得したフォルダと実行中のNodeのパスを保存するため、配置移動・Node更新後は再実行する。

--host codex / --host claude / --host opencode で登録先を一つに限定できる。--dry-run は変更予定の表示だけを行い、登録や解除は実行しない。

VS CodeのGitHub Copilotへの登録は既定で行わない。必要な場合だけ --vscode を付ける(ユーザーの Code/User/mcp.json の multi-agent だけを更新。他の定義は保持。JSONCなど解析できない既存ファイルは書き換えず失敗する)。

$server = Join-Path (Get-Location) "src/server.mjs"
claude mcp add --scope user multi-agent -- node $server
codex mcp add multi-agent -- node $server
claude mcp add --scope user multi-agent -- node "$PWD/src/server.mjs"
codex mcp add multi-agent -- node "$PWD/src/server.mjs"

ソース公開前提

  • config.json・allowlist.json・.env*・data/ は非公開のローカルデータ。サンプル設定とは分離する。

  • 認証は各CLIで管理する。認証ファイル・トークンを本プロジェクトへコピーしない。

  • 新規の実行ログには使用量・成否等のメタデータだけを記録し、依頼・応答・エラー本文・作業パスは記録しない。旧ログには本文が含まれる可能性があるため、既存の data/ も公開しない。

  • private: true で誤ったnpm公開を防ぐ。導入先と開発環境は同じソース構成を使い、ローカル状態はGitへ追加しない。

  • 公開前にGitの追跡対象・履歴を確認する。ignore追加では既存の追跡・履歴は消えない。フォルダ全体のコピーではなくGitの追跡内容だけを公開する。

  • ソース公開の前提は、公開操作・ライセンス選定・認証情報の公開を許可するものではない。

確認

npm test はCLI導入・認証・モデル通信を必要としない回帰試験とMCP統合試験。npm run check:release は構文・lock整合性・Gitの公開候補・ライセンス・ローカルリンクを検査する。CIはNode 24のWindows / macOS / Linuxで同じ自動試験を行う設定になっている。

実環境のCLIモデル一覧は別途 npm run test:smoke で確認する(両CLIとログインが必要。生成依頼なし)。実生成の検証は利用枠を消費するため自動試験・CIに含めない。自動試験の成功は、実モデルやCLI更新後の互換性まで保証するものではない。

任意の実機試験(サブスク利用枠を消費): node test/live.mjs <provider> <許可済みmodel> <許可済みeffort>(制限権限)、node test/full-access-live.mjs <provider> <model> <effort>(既定full-accessの編集・シェル・native継続・取消・timeout・close・履歴非保存)。npm test には子制御の契約試験と、Codex app-server / Claude stream-json の模擬プロセスによるアダプター試験(生成通信なし)を含む。 MXC境界の実機試験(モデル生成なし): node test/mxc-live.mjs。 実モデルによる侵害・予算迂回試験: node test/brokered-live.mjs <provider> <許可済みmodel> <effort>。 full-access-liveの第4引数に許可済みの別モデルを渡すと、同じ会話のまま切り替えて文脈が残ることも確認する。

macOS・Linux

OS別の可否は src/platform.mjs で一元判定する。Windows MXCに依存する機能はmacOS・Linuxで公開しない(ツール一覧・入力項目・instructionsから除去し、弱い方式へ切り替えない)。実CLIを使う前に list_providers とモデル一覧で利用可否を確認する。

機能

Windows

macOS・Linux

full-access(native継続)

○

○

Codex read-only / workspace-write

○(MXC)

○(Codex標準sandbox)

Claude read-only / workspace-write

○(restricted+専用MXCシェル)

×(Claudeはfull-accessのみ)

brokered(run_brokered_agent・isolation)

○

×(ツール・入力項目なし)

run_isolated_code・sandbox_status

○(MXC)

config で sandbox.backend: "docker" を明示した場合のみ

  • 公開ツールはWindows 17件、macOS・Linuxは既定で14件(Dockerを明示設定すると隔離実行の2件が加わる)。

  • 起動ファイルはWindowsの *.cmd に対し、macOSは同名の *.command(Finderでダブルクリック)。端末ごとの許可リストは通常独立している。

  • SSH経由のシェルではmacOSのログインキーチェーンが使えず、Claude Codeが未ログインに見える。MCPホスト(GUIで起動したCodex/Claude Code/OpenCode)からは通常どおり使える。SSHから試験する場合はGUIセッションのLaunchAgentとして実行する。

プロバイダー追加

src/providers/<type>.mjs に export default (id, cfg) => ({ id, type, description, capabilities, available(), listModels(), run() }) を置き、config.json の providers に { "type": "<type>" } を追加する。本体の変更は不要。full-accessのnative継続に対応する場合は openSession()(契約は src/adapters/session.mjs)を実装する。未実装の実行先はreplay継続になる。

ライセンス

Apache-2.0。Codex由来の移植部分の出典・変更対応は src/child-control/README.md、原典の表示は third_party/codex と NOTICE に保持している。依存パッケージ・外部CLIはそれぞれのライセンスと利用条件に従う。

Available Tools

14 tools
cancel_agentA

実行・待機中の子へ取消を要求する。取消要求だけで枠を返さず、終了後にget_agentで確定を確認する

Inputs: job_id (required).

close_conversationA

完了した会話を閉じる。native会話は子プロセスの終了を待って常駐枠を返し、履歴とジョブ結果を破棄する。実行中は取消と終了確認が先に必要

Inputs: conversation_id (required).

get_agentA

開始した子の状態と最終結果だけを取得する。途中イベントはinclude_events、使用量等はinclude_detailsを明示した場合だけ返す。本文は開始したサーバーのメモリに保持

Inputs: job_id (required), after_event, include_events, include_details.

get_policyA

現在の実行ポリシー(再帰上限・権限・タイムアウト・未指定時の挙動など)と呼び出し連鎖の状態を返す

Inputs: no named parameters.

get_runC

実行IDの記録(開始・終了)を返す

Inputs: run_id (required).

list_agentsA

このMCPサーバーが所有するジョブと会話ID・状態を返す(依頼・応答本文は含まない)

Inputs: no named parameters.

list_modelsB

実行時に取得したモデル一覧(ID・対応Effort・既定Effortなど)を返す。モデル名はハードコードされていない

Inputs: refresh, provider, include_hidden, include_disallowed.

list_providersB

登録済みプロバイダーと利用可否・機能(ツール実行・権限範囲など)を返す

Inputs: no named parameters.

run_agentB

子を1件実行し完了を待つ。permission省略はfull-access(信頼する子向け・OSユーザー権限の範囲)。制限はread-only/workspace-write(実行先が対応する場合)。このOSにbrokeredは無い。指定モデル・Effort・権限を検証する

Inputs: task (required), model (required), provider (required), cwd, +11 more.

run_agents_parallelB

複数のサブエージェントを並列実行する(同時実行数はポリシー maxConcurrent で制限)。比較・分担・相互レビューに使う

Inputs: runs (required).

send_agent_messageA

完了した会話へ追加入力して新しいジョブを開始する。native会話は新しい入力だけを同じ子へ送る(過去入力を再送しない)。provider/cwd/権限/隔離方式は変更不可。モデル・Effortは毎回明示し再検証する。同時ターンは不可

Inputs: task (required), model (required), provider (required), conversation_id (required), +11 more.

start_agentA

子をバックグラウンド実行しjobId/conversationIdを即返す。通常の委譲に推奨。完了待ちはwait_agents、最終結果はget_agent(途中イベントは明示要求時のみ)。full-accessは会話ごとの子プロセスで継続(mode=native)

Inputs: task (required), model (required), provider (required), cwd, +11 more.

usage_summaryB

プロバイダー/モデル別の実行回数・成否・所要時間・トークン等の使用量を集計する

Inputs: since, provider.

wait_agentsA

指定ジョブ(省略時は任意のジョブ)が終了するまで待つ。timeout_msは最小値未満を最小値へ補正し、最大値超過は拒否する。期限到達時はtimedOut=trueで戻る。終了通知(jobId/状態のみ)を返す

Inputs: job_ids, timeout_ms.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 14 tools

    Disambiguation4/5

    Most tools have distinct roles, and descriptions explicitly separate the launch trio (run_agent = blocking single, start_agent = background preferred, run_agents_parallel = fan-out). However, get_run vs get_agent vs list_agents overlap conceptually (execution record vs job state vs job listing), and run_agent is fully reproducible via start_agent + wait_agents, which invites misselection.

    Naming Consistency4/5

    Nearly everything follows verb_noun snake_case (list_*, get_*, run_*, start_*, cancel_agent, close_conversation, send_agent_message). Minor deviations: usage_summary lacks a verb, run_agents_parallel adds a modifier, and singular/plural is inconsistent across get_agent vs wait_agents/list_agents.

    Tool Count5/5

    14 tools sits squarely in the well-scoped range, and each tool maps to a real orchestration step (discovery, launch, wait, inspect, cancel, cleanup, observability, policy). No tool appears redundant enough to drop.

    Completeness4/5

    The agent lifecycle is well covered end to end: discover providers/models, start/run, wait, fetch results, message, cancel, close, plus usage and policy introspection. Gaps: policy is read-only (get_policy with no set/update), and there is no way to retrieve full conversation history/transcripts before close_conversation discards them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers