Roblox Studio MCP Server

What is Roblox Studio MCP Server about?

Enables Roblox Studio to interact with AI tools like Claude Desktop and Cursor. The server acts as a bridge, handling long‑poll requests from a Studio plugin and forwarding tool commands to the AI client through a standard protocol.

How to use Roblox Studio MCP Server?

1. Install with release binaries – download the appropriate package from the releases page, run the installer, then restart Claude/Cursor and Roblox Studio.
2. Manual configuration – add a server entry to the MCP client config JSON, pointing to the downloaded rbx-studio-mcp executable (Windows) or the app bundle path (macOS).
3. Build from source – install Rust, clone the repository, and execute cargo run. The command builds the server, registers Claude, and installs the Studio plugin.
4. Verify – open Roblox Studio, locate the MCP plugin under the Plugins tab, and confirm the console message The MCP Studio plugin is ready for prompts..
5. Send requests – type a prompt in Claude Desktop, accept the permission dialog, and watch the requested action (e.g., inserting a model) occur in Studio.

Key Features

• Axum‑based web server that long‑polls the Studio plugin.
• rmcp server communicating with Claude via stdio.
• Automatic setup for Claude Desktop and Cursor when they are detected.
• Simple manual configuration using a JSON snippet.
• Cross‑platform support (Windows and macOS).
• Provides two built‑in tools: insert_model and run_code.

Use Cases

• AI‑assisted Roblox development – generate and insert assets or scripts directly from natural‑language prompts.
• Rapid prototyping – run code snippets in a live Studio session without manual typing.
• Tool integration – allows third‑party LLMs to extend Studio functionality through a standardized protocol.

FAQ

Q: Will third‑party tools be able to modify my place? A: Yes. The MCP server grants connected tools read/write access to the open place. Review each tool’s privacy policy.

Q: Which operating systems are supported? A: Pre‑built binaries are provided for Windows and macOS. Building from source works on any platform with Rust.

Q: How do I restart the connection if it stops working? A: Close both Roblox Studio and the AI client, then reopen them. The plugin will re‑establish the long‑poll connection on launch.

Q: Can I use a different AI assistant? A: Any client that implements the Model Context Protocol can be added by editing the MCP client config.

Roblox Studio MCP Server

This repository contains a reference implementation of the Model Context Protocol (MCP) that enables communication between Roblox Studio via a plugin and Claude Desktop or Cursor. It consists of the following Rust-based components, which communicate through internal shared objects.

• A web server built on axum that a Studio plugin long polls.
• A rmcp server that talks to Claude via stdio transport.

When LLM requests to run a tool, the plugin will get a request through the long polling and post a response. It will cause responses to be sent to the Claude app.

Please note that this MCP server will be accessed by third-party tools, allowing them to modify and read the contents of your opened place. Third-party data handling and privacy practices are subject to their respective terms and conditions.

The setup process also contains a short plugin installation and Claude Desktop configuration script.

Setup

Install with release binaries

This MCP Server supports pretty much any MCP Client but will automatically set up only Claude Desktop and Cursor if found.

To set up automatically:

1. Ensure you have Roblox Studio, and Claude Desktop/Cursor installed and started at least once.
2. Exit MCP Clients and Roblox Studio if they are running.
3. Download and run the installer:
   1. Go to the releases page and download the latest release for your platform.
   2. Unzip the downloaded file if necessary and run the installer.
   3. Restart Claude/Cursor and Roblox Studio if they are running.

Setting up manually

To set up manually add following to your MCP Client config:

{
  "mcpServers": {
    "Roblox Studio": {
      "args": [
        "--stdio"
      ],
      "command": "Path-to-downloaded\\rbx-studio-mcp.exe"
    }
  }
}

On macOS the path would be something like "/Applications/RobloxStudioMCP.app/Contents/MacOS/rbx-studio-mcp" if you move the app to the Applications directory.

Build from source

To build and install the MCP reference implementation from this repository's source code:

1. Ensure you have Roblox Studio and Claude Desktop installed and started at least once.
2. Exit Claude and Roblox Studio if they are running.
3. Install Rust.
4. Download or clone this repository.
5. Run the following command from the root of this repository.

   cargo run
   

   This command carries out the following actions:
   • Builds the Rust MCP server app.
   • Sets up Claude to communicate with the MCP server.
   • Builds and installs the Studio plugin to communicate with the MCP server.

After the command completes, the Studio MCP Server is installed and ready for your prompts from Claude Desktop.

Verify setup

To make sure everything is set up correctly, follow these steps:

1. In Roblox Studio, click on the Plugins tab and verify that the MCP plugin appears. Clicking on the icon toggles the MCP communication with Claude Desktop on and off, which you can verify in the Roblox Studio console output.
2. In the console, verify that The MCP Studio plugin is ready for prompts. appears in the output. Clicking on the plugin's icon toggles MCP communication with Claude Desktop on and off, which you can also verify in the console output.
3. Verify that Claude Desktop is correctly configured by clicking on the hammer icon for MCP tools beneath the text field where you enter prompts. This should open a window with the list of available Roblox Studio tools (insert_model and run_code).

Note: You can fix common issues with setup by restarting Studio and Claude Desktop. Claude sometimes is hidden in the system tray, so ensure you've exited it completely.

Send requests

1. Open a place in Studio.
2. Type a prompt in Claude Desktop and accept any permissions to communicate with Studio.
3. Verify that the intended action is performed in Studio by checking the console, inspecting the data model in Explorer, or visually confirming the desired changes occurred in your place.