rbx-mcp-engine by fxrrysalim - MCP Server

Roblox Studio MCP Server (Ultimate Edition)

The most advanced, high-performance bridge between Roblox Studio and AI Agents (Cursor, Claude, Windsurf, etc.). Built for speed, reliability, and deep engine access.

🚀 Key Evolution: This engine replaces the traditional HTTP polling mechanism with a persistent WebSocket architecture, enabling zero-latency communication and real-time event listening.

🌟 Features

⚡ Performance & Stability

Real-time WebSocket: Instant execution. No more 15-second polling delays found in standard implementations.
Auto-Healing Connection: The plugin automatically reconnects if the server restarts. Immortal uptime.
Time-Sliced Scanning: Scans massive maps (100k+ parts) without freezing Roblox Studio.

🧠 Intelligence & Vision

Deep Engine Awareness: Inspect hierarchy, properties (Lighting, Physics, UI), and hidden attributes.
Spatial Radar: Perform Raycasts and Region queries to "see" the 3D world, even invisible objects.
Code Analyst: Read script source code and automatically resolve require() dependencies to understand context.

🎮 Control & Reactivity

God Mode Execution: Execute privileged Luau code with smart stack trace capturing.
Reactive Events: Wait for specific game events (WaitForChild) instead of blind execution.
Backend Admin: Manage DataStores directly (Get/Set/Remove) for economy and save system debugging.

🛠️ Toolset Reference (10 Tools)

This server exposes 10 powerful tools to your AI agent:

Category	Tool Name	Description
Logic	`run_code`	Execute privileged Luau code. Captures print/warn/error output.
Logic	`read_script_source`	Read script content and resolve module dependencies.
Vision	`scan_hierarchy`	Scan the game tree (Workspace, Services) with depth control.
Vision	`get_selection`	Get detailed properties of selected objects (Physics, Tags, Attributes).
Vision	`get_type_definition`	Query the engine for supported properties of a specific Class.
Spatial	`spatial_query`	Perform 3D Raycasts or Region checks to detect objects.
Assets	`insert_model`	Search and insert assets/models from the Roblox Toolbox.
Reactive	`wait_for_event`	Pause execution until a specific object appears (Event-driven).
Reactive	`listen_to_console`	Stream Studio Output/Errors to the AI in real-time.
Backend	`manage_datastore`	Direct access to DataStoreService for database management.

📦 Installation

Prerequisites

Roblox Studio installed.
(Optional) Rust Toolchain if building from source.

Quick Start

Download the latest rbx-studio-mcp.exe from the .
Run the executable.
- It will automatically install the plugin (MCPStudioPlugin.rbxm) to your Roblox Studio Plugins folder.
- It will display the JSON configuration you need.

⚙️ Configuration

Add the following configuration to your MCP Client's config file (e.g., claude_desktop_config.json, .cursor/mcp.json, or others).

Universal Config:

{
  "mcpServers": {
    "roblox": {
      "command": "C:/Path/To/rbx-studio-mcp.exe",
      "args": ["--stdio"]
    }
  }
}

Note: Replace C:/Path/To/rbx-studio-mcp.exe with the actual path where you saved the executable.

🏗️ Architecture

graph LR
    A[AI Client] <-->|Stdio JSON-RPC| B(Rust MCP Server)
    B <-->|WebSocket| C(Roblox Studio Plugin)
    C -->|Luau| D[Roblox Engine]

AI Client sends a tool request via Stdio.
Rust Server translates this into a WebSocket message.
Roblox Plugin receives the message, executes it in the high-privilege plugin security context, and streams the result back.

🤝 Acknowledgements & Credits

This project is an advanced evolution based on the foundational work from the Official Roblox MCP Server.

Upstream/Inspiration: Roblox/studio-rust-mcp-server

We acknowledge the Roblox Team for establishing the MCP protocol standards for the platform. This fork diverges by implementing a full WebSocket architecture (replacing HTTP polling) and expanding the toolset from 2 basic tools to 10 advanced engineering tools.

📄 License

MIT License. Free to use, modify, and distribute.