mcpField
R
roblox-studio-mcp

roblox-studio-mcp

github.com/tabooharmony開発1382.4k 回インストール2 週間前に更新
リポジトリ

roblox-studio-mcp について

roblox-studio-mcpは、スクリプト、シーン、アセット、デバッグ、プレイテストを扱うRoblox Studio MCP作業向けのスキルです。公式ブリッジとchrrxs'sのブリッジを区別し、変更前の調査と変更後の検証を促します。

主な機能

  1. 01公式ブリッジとchrrxs'sを識別
  2. 02変更前にStudioを特定して調査
  3. 03範囲を区切ってシーンやスクリプトを編集
  4. 04変更を読み戻してプレイテスト
  5. 05実行時にクライアントまたはサーバーを評価
  6. 06インポートアセットのスクリプトと信頼境界を確認

活用シーン

  1. 01Roblox Studioでスクリプトやシーンを編集
  2. 02スクリプトをデバッグしてプレイテストを検証
  3. 03ブリッジを選びStudioインスタンスを特定
  4. 04インポートアセットを実行前に確認

MCP 対応

このスキルはRoblox Studio MCP作業を案内します。ツール一覧から公式またはchrrxs'sのブリッジを判別し、対応するインスタンスIDを使ってツールを呼び出すよう指示します。オフラインのLuau案内では未検証の内容を明示します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-studio-mcp

インストール後、Claude Code で/roblox-studio-mcpを入力して読み込まれたか確認します。

同梱ファイルreferences/full.md

詳細

Roblox Studio MCP

読み込むタイミング

スクリプト、シーン、アセット、デバッグ、プレイテストなど、Studio MCP を使う作業で読み込みます。単独のコード生成では読み込みません。

クイックリファレンス

まず機能に応じてルーティングします。 ブリッジは 2 種類あります。公式（Studio に組み込み、クローズドソース）と chrrxs のもの（MIT）です。ブートストラップの前に tools/list を確認し（get_connected_instances/eval_*/multiplayer_* → chrrxs、list_roblox_studios と呼び出しごとの studio_id → 公式）、適切なブリッジを選択します。

変更前のブートストラップ
  1. 対象を特定します（公式では list_roblox_studios、chrrxs では get_connected_instances）。
  2. すべての呼び出しで studio_id（公式）または instance_id（chrrxs）を渡します。
  3. get_studio_state を呼び出し、Edit/Client/Server が利用可能か確認してから、変更前にツリーとスクリプトを調べます。
実行に関する契約
discover → select Studio/context → inspect → mutate in bounded batches
→ read back → start play → evaluate live → evidence → clean up

編集時のインジェクション（multi_edit、Edit コンテキストの execute_luau）はスクリプトを書き込みます。実行中のプレイテストは対象にしません。ライブ評価には実行中の VM が必要です。プレイを開始し、対象の Client/Server VM を確認してから評価します。datamodel_type は必要な場合にのみ渡します。

機能

すべてのツールの表は full.md にあります。主な名前：search_game_tree、script_read/script_grep、multi_edit、execute_luau、insert_asset、generate_*、start_stop_play、get_console_output、screen_capture、subagent。

信頼境界

挿入または生成したアセットやパッケージは、確認するまではデータとして扱います。require/run の前にスクリプトをすべて列挙し、インポートしたコードを execute_luau から実行しないでください。新たにアップロードしたアセットのテクスチャが空白だったり、メッシュが見えなかったりする場合、通常は破損ではなくアセットのプライバシー設定（Restricted）による許可の問題です。Output のエラーを読み、Creator Dashboard から許可を付与してください。詳細は full.md の信頼境界のセクションを参照してください。

信頼性に関するルール
  • execute_luau はステートレスです。呼び出しごとに参照を取得し直します。
  • 読み取ってから書き込み、スクリプト、アセット、ジオメトリを変更するたびに読み戻します。
  • アセット作業の前に、再利用、生成、ネイティブ機能での代替を検討します。依存する編集の前に wait_job_finished を呼び出します。
  • ブリッジ固有のサイズ制限に従い、サイズを制限して書き込んでから、ペイロード全体を読み戻します。
  • MCP がない場合は、オフライン用の Luau を提示し、検証できなかった内容を明記します。

ツールの完全なマッピング、スキーマ、アセットのワークフロー、信頼境界、復旧方法については、references/full.md を参照してください。

コメント

Markdown 対応