MCP

Model Context Protocol（MCP） 統合により、Claude Code や Cursor などの AI アシスタントが、実行中の Turian ゲームをリアルタイムで検査し、操作できるようになります。LLM は状態を推測する代わりに、実際のシーン、エンティティ、コンポーネント、パフォーマンスメトリクスを直接クエリできます。

仕組み

Claude Code / Cursor
      │  MCP（stdio、JSON-RPC 2.0）
      ▼
turian-cli mcp
      │  リモートデバッグプロトコル（TCP、ポート 7777）
      ▼
  実行中のゲーム（デバッグサーバー有効）

turian-cli mcp は 2 つのプロトコルを橋渡しします。stdin から MCP リクエストを読み取り、TCP 経由でゲームのデバッグサーバーに転送し、構造化された結果を返します。

クイックスタート

1 — ゲームでデバッグサーバーを有効にする

ゲームのエントリポイントで、メインループの前にデバッグサーバーを起動します：

const debug = @import("debug");

var srv = debug.Server.init(allocator, .{});
defer srv.deinit(io);
try srv.start(io, .{ .ctx = &world, .getFn = myWorldProvider });

サーバーはデフォルトで 127.0.0.1:7777 をリッスンします。

2 — MCP クライアントを設定する

Claude Code（~/.claude/mcp.json またはプロジェクトの .mcp.json）：

{
  "mcpServers": {
    "turian": {
      "command": "turian-cli",
      "args": ["mcp"]
    }
  }
}

認証トークンを使用（デバッグサーバーが --token で起動された場合）：

{
  "mcpServers": {
    "turian": {
      "command": "turian-cli",
      "args": ["mcp", "--token", "my-secret"]
    }
  }
}

カスタムホスト/ポート：

{
  "mcpServers": {
    "turian": {
      "command": "turian-cli",
      "args": ["mcp", "--host", "192.168.1.10", "--port", "7778"]
    }
  }
}

3 — ゲームを起動して質問する

ゲームが実行され、Claude Code が接続されたら、次のように質問できます：

"どのシーンが読み込まれていますか？" "Player エンティティを検査してください。" "現在の FPS とメモリ使用量は？" "Camera コンポーネントを持つすべてのエンティティを一覧表示してください。"

利用可能なツール

読み取りツール

書き込みツール（読み書きサーバー + confirm: true）

書き込みツールは確認ゲートを使用します。最初の呼び出しはプレビューを返し、confirm: true を渡すと実際に変更が適用されます。

CLI リファレンス

turian-cli mcp [--host <addr>] [--port <n>] [--token <secret>]

turian-cli mcp は stdin が閉じられると終了します。MCP クライアントがそのライフタイムを制御します。

プロトコル詳細

• トランスポート：stdio 上の JSON-RPC 2.0、改行区切り
• MCP バージョン：2024-11-05
• 機能：tools（一覧表示 + 呼び出し）
• デフォルトで読み取り専用：デバッグサーバーが読み書きモードで起動されていない場合、変更ツールはエラーを返します

関連情報

• リモートデバッグプロトコル——基盤となる TCP レイヤー
• ランタイムイントロスペクション——両方のレイヤーが利用するエンジン API
• CLI リファレンス——その他の turian-cli コマンド

← すべてのドキュメント このページを編集