Universal MCP Lab

動的機能獲得を検証するための最小限の概念実証 動的ケイパビリティ獲得 を、安定したMCPサーフェスの背後で検証します。

仮説

エージェントは6つの安定したツールから始まります。OpenAPIサービスに接続し、新しい内部ケイパビリティを発見し、それらを検査・呼び出ししても、公開されたMCPカタログは変更されません。

想定される安定したサーフェス:

• services.connect

• services.disconnect

• services.list

• capabilities.list

• capabilities.describe

• capabilities.invoke

このPoCは、マシンへの直接アクセスを許可せず、任意のシェルを公開せず、認証情報を保存しません。

Related MCP server: openapi-mcp

ローカルでテストを実行する

python -m unittest discover -s tests -v
python scripts/demo.py

実際のMCPをstdio経由で

フェーズ3では、6つの安定したツールを備えた実際のMCPサーバーを組み込みます。宣言された依存関係をインストールし、MCPホストにプロセスを起動させます:

pip install -e .
python -m entradas.mcp.server

このプロセスはインターフェースを表示せず、stdoutに書き込んではいけません。stdin 経由でMCPメッセージを待機します。テスト tests/test_mcp_protocol.py は実際のMCPクライアントとして動作し、tools/list を検証し、OpenAPI合成を接続し、公開カタログが変更されないことを確認します。

このローカル転送は意図的に制限されています。HTTPを公開せず、OAuthを含まず、PCに接続せず、書き込み承認を有効にしません。

ラボでHTTP読み取りを有効にするには、起動前にローカルの許可リストを設定します。MCP経由で送信されるOpenAPIドキュメントは、その宛先を変更できません:

$env:UNIVERSAL_MCP_READ_BASE_URLS = '{"customers":"https://api.example.test"}'
python -m entradas.mcp.server

設定されたサービスへの GET のみが実行されます。タイムアウト、サイズ制限、必須JSON、リダイレクトなし、再試行なし。このスイートはインターネットを使用しません。ローカルの一時エンドポイントを起動して、このフローを検証します。

ローカルノード

PCノードは、リモート制御機能ではなく、分離されたローカルMCPプロセスです。マシンの所有者のみが起動し、明示的なフォルダを設定できます:

$env:UNIVERSAL_MCP_OWNER_ALLOWED_ROOT = 'C:\carpeta-autorizada'
python -m entradas.pc_node.server

その唯一のツールは pc.read_text(relative_path) です。シェル、書き込み、ディスク探索、ブラウザ、プロセス、ネットワークリスナーは含まれません。ゲートウェイとこのノード間のトンネルと認証は、後のフェーズに属します。

書き込みのアクションバウンダリ

書き込みは approved=true を受け入れません。最初のリクエストは確認参照を返します。信頼できるヒューマンインターフェースが、MCPの外部でその正確なアクションを承認する必要があります。結果として得られる認可は一度きりで、同じ引数に結び付けられ、executorの前に消費されます。これにより、PCノードへの書き込みはまだ有効になりません。

ステータス

アーキテクチャ + ラボのコア + ディープなECAが準備完了です。STATUS.md と docs/PLAYBOOK.md を参照してください。