Roblox Executor MCP

🚀 Roblox Executor MCP Server

LLMと実行中のRobloxゲームクライアントを接続するMCPサーバーです。コードの実行、スクリプトの検査、リモートの監視などの機能を提供します。

✨ 主な機能

• コード実行とデータクエリ — Luaコードを実行し、ゲームクライアントからデータを取得します。
• スクリプト検査 — LocalScripts/ModuleScriptsを逆コンパイルし、ソースを検索します。
• インスタンス検索 — QueryDescendantsを使用したCSSライクなセレクターと階層ツリーによるインスタンス検索が可能です。
• リモート監視 — Cobaltを統合し、リモート/バインダブルのインターセプト、ログ記録、ブロック、無視ができます。
• マルチクライアント — 複数のRobloxクライアントを同時に接続でき、clientIdで各クライアントをターゲットにできます。ダッシュボードはhttp://localhost:16384/で確認できます。
• スクリーンショット — Robloxウィンドウのスクリーンショットを撮影できます（Windowsのみ）。セカンダリとして実行する場合は、プライマリホストに転送されます。
• プライマリ/セカンダリ — 複数のMCPインスタンスが自動的に調整され、セカンダリはプライマリを介して中継します。プライマリが切断された場合、セカンダリが自動的に昇格します。--baseurlを使用してリモートプライマリをサポートします。

📦 インストール

前提条件

• loadstring、request、（できれば）WebSocketをサポートするRobloxエグゼキューター
• Node.js ≥ 18

インストール手順

pnpm install && pnpm run build

🚀 クイックスタート

AIクライアントへの追加

Cursor — 設定 > 機能 > MCP > 追加: 名前 roblox-executor-mcp、タイプ command、コマンド node /path/to/MCPServer/dist/index.js

Claude Desktop / Antigravity — JSON設定に追加:

{
  "mcpServers": {
    "roblox-executor-mcp": {
      "command": "node",
      "args": ["/path/to/MCPServer/dist/index.js"]
    }
  }
}

Codex — 設定 > MCP設定 > サーバー追加: 名前 roblox-executor-mcp、タイプ STDIO、コマンド node、引数 /path/to/MCPServer/dist/index.js

Robloxからの接続

エグゼキューターでconnector.luauを実行するか、クイックローダーを使用します。

-- getgenv().BridgeURL = "10.0.0.4:16384" (デフォルトはlocalhost、必要に応じて変更)
-- getgenv().DisableWebSocket = true
-- getgenv().DisableInitialScriptDecompMapping = true (スクリプト関連のツールを実行するまでスクリプトの逆コンパイルを無効にする)
loadstring(game:HttpGet("https://raw.githubusercontent.com/notpoiu/roblox-executor-mcp/refs/heads/main/connector.luau"))()

💻 使用例

ツール一覧

🔧 プライマリ/セカンダリモード

デフォルトでは、サーバーはポート16384でプライマリとして起動します。そのポートが既に使用されている場合、自動的にセカンダリになり、すべてのツール呼び出しをプライマリを介して中継します。プライマリが切断された場合、セカンダリが自動的に昇格します。

リモートプライマリ (--baseurl)

このインスタンスをリモートのプライマリのセカンダリとして接続します。AIクライアントがmacOS/Linuxにあり、RobloxがWindowsマシンにある場合に便利です。

{
  "mcpServers": {
    "roblox-executor-mcp": {
      "command": "node",
      "args": [
        "/path/to/MCPServer/dist/index.js",
        "--baseurl",
        "http://<primary-host>:16384"
      ]
    }
  }
}

注意: screenshot-windowとlist-roblox-windowsはHTTPを介してプライマリに転送されるため、MacのセカンダリはWindowsのプライマリで実行されているウィンドウのスクリーンショットを撮影できます。

📄 セキュリティに関する注意

⚠️ 重要提示

• 任意コード実行 — 信頼できるLLMとのみ使用してください。接続されたAIクライアントは、Robloxセッションでコードを実行できます。
• HTTPサーバーをインターネットに公開しないでください。 ポート16384は認証されていません。このポートにアクセスできる人は誰でも、ゲーム内でコードを実行し、画面のスクリーンショットを撮影し、クライアントデータを読み取ることができます。マシン間でのアクセスが必要な場合（例: --baseurl）は、ローカルネットワーク/VPNまたはSSHトンネルを使用してください。パブリックルーターやクラウドファイアウォールを介してポートを転送しないでください。