enginegate

enginegate

enginegate は、実行中の Unreal Editor への単一の入口をエージェントに提供します。エディターツールを長々と並べる代わりに、unreal という単一のゲートウェイツールを公開し、4 つの操作を提供します。平易な言葉でエディターの機能を検索する、使用前に機能の契約を確認する、機能を実行する、有効にする機能グループを設定する、の 4 つです。

すべての呼び出しはエディター独自のローカル MCP エンドポイントに転送されるため、enginegate はそのエンドポイントを備えたエディターの実行中にのみ動作します。エディターが実行されていない場合、呼び出しは元の接続問題を含むエラーを返します。enginegate がエディターの結果を捏造することはありません。

インストール

npx @reneturcios/enginegate call '{"operation":"search","query":"spawn actor"}'

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/enginegate

コンテナーはデフォルトで MCP サーバーとして動作します（下記参照）。CLI として使用するには、CLI 引数を渡してください。

設定

環境変数	意味
UNREAL_MCP_URL	エディターの MCP エンドポイントです。デフォルト：http://127.0.0.1:3000/mcp
MCP_AUTOMATION_CAPABILITY_TOKEN	設定すると、転送されるすべての呼び出しで X-MCP-Capability-Token ヘッダーとして送信されます。

CLI

# Search capabilities in plain words
enginegate call '{"operation":"search","query":"spawn actor"}'

# Read one internal tool's contract
enginegate call '{"operation":"describe","tool":"control_actor"}'

# Execute a capability by tool + action, or by capability id
enginegate call '{"operation":"execute","tool":"control_actor","action":"spawn","params":{"class":"PointLight"}}'
enginegate call '{"operation":"execute","capability":"control_actor.spawn","params":{"class":"PointLight"}}'

# Configure capability groups
enginegate call '{"operation":"configure","tool":"control_actor","params":{"enabled":true}}'

enginegate --version

終了コード：成功時は 0、呼び出しの検証に失敗した場合、エディターに接続できない場合、またはエディターがエラーを返した場合は 1、使用方法に誤りがある場合は 2 です。

引数の要件は転送前に確認され、不足しているフィールドがエラーに示されます。

• search には query が必要です
• describe には tool が必要です
• execute には tool + action、または capability が必要です
• configure には tool または params が必要です

MCP サーバー

1 つのバイナリで両方の用途に対応します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/enginegate mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "enginegate": {
      "command": "npx",
      "args": ["-y", "@reneturcios/enginegate", "mcp"]
    }
  }
}

ツール

ツール	入力	動作
unreal	operation（必須。search、describe、execute、configure のいずれか）、および操作ごとのフィールド：query、tool、action、capability、params、consent	実行中のエディターのゲートウェイに呼び出しを転送します。describe は機能の契約を返します。破壊的な機能の場合は同意許可も含まれます。この許可は、その機能を execute で実行する際に consent として渡す必要があります。

転送される呼び出しは、ツール名 unreal に対する JSON-RPC tools/call リクエストです。エディターのエンドポイントは、プレーンな JSON 本文または Server-Sent Events ストリームを返す場合があります。どちらも解析され、呼び出し元にはエディター独自の結果テキスト（およびエラーフラグ）が返されます。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。