🎮 Roblox Studio Ultimate MCP Server

English | 日本語

Roblox Studioのための最も包括的なMCP（Model Context Protocol）サーバーです。Claude CodeやMCP互換のAIアシスタントからStudioを完全に制御するための41個のツールを提供します。

✨ このサーバーが存在する理由

標準のRoblox Studio MCPは run_code しか提供しておらず、文字列操作（gsub）を介してスクリプトソースを操作することを強制されます。これにより、以下のような問題が発生します：

❌ パターンマッチングの失敗
❌ end) ステートメントの破損
❌ スクリプトが元に戻る際のサイレントロールバック
❌ 書き込み前の構文チェックがない
❌ 単純な編集に費やされる無駄な時間

このMCPは、これらすべてを解決します。

🚀 機能

スクリプト操作（ゲームチェンジャー）

ツール	説明
`getScript`	完全なソースコードを取得
`setScript`	ソース全体を置換（構文チェック＋自動バックアップ付き）
`editScript`	特定の行範囲を編集（部分編集！）
`insertCode`	特定の行の後にコードを挿入
`removeLines`	特定の行を削除
`replaceInScript`	テキストの検索と置換（プレーンテキスト、安全）
`getLines`	特定の行範囲のみを取得（軽量）
`getFunctionList`	行番号付きですべての関数をリストアップ
`getScriptSummary`	概要：関数、require、グローバル変数
`listScripts`	ゲーム内のすべてのスクリプトをリストアップ
`getAllScripts`	すべてのスクリプトソースを一括取得
`searchInScripts`	すべてのスクリプトからキーワードを検索
`getReferences`	変数/関数のすべての使用箇所を検索
`getModuleDependencies`	require() 依存関係をリストアップ

安全メカニズム

機能	説明
🔒 構文チェック	書き込み前に自動検証。不正なコードを拒否。
💾 自動バックアップ	編集のたびに以前のバージョンを保存（10世代分）
🛑 プレイモードガード	プレイモード中の書き込みをブロック（サイレントロールバックを防止）
📝 UpdateSourceAsync	ScriptEditorServiceを使用して競合のない書き込みを実現

バックアップと復元

ツール	説明
`restoreBackup`	自動保存されたバックアップから復元
`listBackups`	利用可能なバックアップをリストアップ

検証

ツール	説明
`checkSyntax`	書き込まずに構文をチェック
`verifyScript`	行数/ソースの長さを検証
`validateAllScripts`	すべてのスクリプトを一括構文チェック

インスタンス操作

ツール	説明
`getTree`	インスタンス階層を取得
`getChildren`	子要素をリストアップ（軽量）
`getProperty` / `setProperty`	プロパティの取得/設定
`createInstance`	新しいインスタンスを作成
`deleteInstance`	インスタンスを削除
`cloneInstance`	インスタンスを複製
`renameInstance`	インスタンスの名前を変更
`moveInstance`	別の親へ移動
`findInstances`	名前/クラスでインスタンスを検索

その他

ツール	説明
`runCode`	Luauコードを実行（出力キャプチャ付き）
`batch`	複数のコマンドを一括実行
`getAttribute` / `setAttribute`	属性操作
`getErrors` / `clearErrors`	エラーログ管理
`undo` / `redo`	アンドゥ/リドゥ操作
`getSelection`	現在の選択範囲を取得
`getStudioInfo`	Studio情報を取得

📦 インストール

1. クローンとビルド

git clone https://github.com/YOUR_USERNAME/roblox-studio-ultimate-mcp.git
cd roblox-studio-ultimate-mcp
npm install
npm run build

2. Studioプラグインのインストール

プラグインファイルをRobloxのPluginsフォルダにコピーします：

Mac:

cp plugin/UltimateMCP.rbxmx ~/Documents/Roblox/Plugins/

Windows:

copy plugin\UltimateMCP.rbxmx %LOCALAPPDATA%\Roblox\Plugins\

またはソースから生成します：

bash generate-plugin.sh

3. StudioでHTTPを有効にする

Roblox Studioを開き、コマンドバー（View → Command Bar）で以下を実行します：

game:GetService("HttpService").HttpEnabled = true

4. Claude Codeへの登録

適切なプロジェクトの ~/.claude.json に以下を追加します：

{
  "mcpServers": {
    "roblox_ultimate": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/roblox-studio-ultimate-mcp/dist/index.js"],
      "env": {}
    }
  }
}

5. 再起動

Roblox Studioを再起動（プラグインを読み込むため）
Claude Codeを再起動（MCPに接続するため）

🏗️ アーキテクチャ

Claude Code ←(stdio)→ MCP Server (Node.js) ←(HTTP)→ Studio Plugin (Luau)
                         Port 3002

MCPサーバー (src/index.ts): MCPツール呼び出しをHTTPコマンドに変換
Studioプラグイン (plugin/RobloxMCP.lua): サーバーをポーリングし、Studio内でコマンドを実行
通信: HTTPポーリング（300ms間隔）

🔧 他のMCPサーバーとの併用

このサーバーは、公式のRoblox Studio MCPと併用できるように設計されています：

ユースケース	推奨MCP
スクリプトの読み書き	Ultimate (getScript/setScript)
プレイテスト	Official (start_stop_play)
コンソール出力	Official (get_console_output)
インスタンス操作	Ultimate
プロパティ変更	Ultimate

📝 実用的なインパクト

このMCP以前は、260行のスクリプトの1行を修正するのに以下が必要でした：

run_code でソースを取得
gsub パターンマッチング（よく失敗する）
run_code で書き戻し
うまくいくことを祈る
3〜5回繰り返す

現在: editScript(path, 103, 103, "new code") → 完了。一発で成功。

🤝 コントリビューション

プルリクエストを歓迎します！特に以下のような貢献をお待ちしています：

新しいツール
より良いエラーハンドリング
パフォーマンスの向上
ドキュメントの改善

📄 ライセンス

MIT

Roblox Studio Ultimate MCP Server