MCPサーバー操作編 | Gua 日本語リファレンス

先にゲームを起動する

AI clientstdio →gui-mcpWebSocket →Game bridge→Gua adapter

MCPサーバー自身はUI状態を持ちません。Godotアプリがブリッジを起動し、ws://127.0.0.1:8765で待ち受けている必要があります。

MCPクライアントへ登録

Bun環境では公開パッケージをbunxで起動する。クライアントの設定形式に合わせ、次のコマンドと引数を登録する。

MCP設定例json

{
  "mcpServers": {
    "gua": {
      "command": "bunx",
      "args": ["gui-mcp@latest", "mcp"],
      "env": {
        "GUA_BRIDGE_URL": "ws://127.0.0.1:8765"
      }
    }
  }
}

使えるツール

get_ui_tree

現在の画面とSemantic UI Treeを取得する。操作前の第一手。

click_node

安定IDを指定してクリック要求を送る。

wait_for_node

ノードの出現や状態変化を待つ。

press_key

現在フォーカス中の要素などへキー入力要求を送る。

get_screenshot

ランタイムが公開したスクリーンショットを取得する。

get_logs / run_test

ログ確認と、ランタイム側テスト操作を実行する。

AIへの頼み方

プロンプト例text

GuaのUIツリーを取得し、「Start Game」ボタンを探してください。
見つかった安定IDを使ってクリックし、
「Loading...」が表示されるまで待ってください。
失敗した場合はログを確認し、UIツリーと原因を報告してください。