Roblox Executor MCP Server

An advanced Model Context Protocol (MCP) server that allows AI agents to interact with running Roblox game clients. This server enables code execution, script decompilation, instance hierarchy querying, remote event spying and firing, and real-time log streaming.

---

🚀 Key Features

• Code Execution — Run Luau code on the client dynamically, with optional return value yielding.
• Script Inspection — Decompile scripts, search across sources, and perform semantic searches.
• Instance Search & Manipulation — Use CSS-like selectors, traverse the instance hierarchy tree, and query dynamic properties/attributes.
• Remote Spy & Fire — Intercept, log, block, ignore, and fire RemoteEvents / RemoteFunctions (backed by Cobalt).
• Real-Time Log Streaming — Capture client console outputs dynamically via WebSockets and view them live.
• GUI Interaction — Automate input by clicking buttons and typing text into UI elements.
• OS Integrations — Retrieve list of Roblox processes and capture client window screenshots (Windows only).
• Multi-Client Routing — Coordinate between multiple running clients with automatic Primary/Secondary promotion and relaying.
• Local Script Hub — Save, load, and execute pre-configured Luau scripts.

---

🖥️ Local Web Dashboard

The Roblox Executor MCP includes a rich, responsive local web dashboard hosted at:

http://localhost:16384/

Use the dashboard to monitor connected clients, debug executables, and inspect games:

1. Console Tab (New): A real-time stream of the Roblox client console logs (LogService.MessageOut), color-coded by log levels: Info (White), Warning (Yellow), and Error (Red).
2. Executor Tab (New): A developer-focused suite to write Luau code directly, toggle “Get Return Value” to yield and print results, and instantly execute scripts saved in the user-scripts/ hub.
3. Tools Tab: A control center to run all registered MCP tools manually and review inputs/outputs.
4. Scripts Tab: Explore local and decompiled scripts, search sources, index game hierarchies, and set up semantic vector search.

---

🛠️ Complete Tool Catalog

The server registers a comprehensive list of tools for connected AI agents:

1. Client Management

• list-clients — Lists all currently connected Roblox game clients.
• set-active-client — Selects the active target client for subsequent tool operations.

2. Execution Tools

• execute — Executes raw Luau code on the active Roblox client.
• execute-file — Executes a Luau file from the server’s local path.
• teleport-player (New) — Relocates the player to specific coordinates, offsets, or target players.