Enables AI-assisted creation and manipulation of game objects in Roblox Studio, allowing programmatic control over parts, properties, and positioning within the Roblox development environment through HTTP communication with a plugin.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Roblox Studio MCP Assistantadd a red brick wall 10 studs wide at position 20, 5, -15"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Roblox Studio MCP Assistant - Quick Start
1. Installation
Step A: Setup Node Server
Open terminal in this folder (
C:/Desktop/roblox-studio-mcp-server-V1).Install dependencies:
npm installBuild the server:
npm run build
Step B: Install Roblox Plugin
Copy the file
plugin/loader.server.luafrom this folder.Open Roblox Studio.
Right-click ServerScriptService in the Explorer -> Paste into.
(Optional) For permanent installation, save it to your local Plugins folder (
%LOCALAPPDATA%\Roblox\Plugins).
Step C: Configure Cursor MCP
Add this to your MCP settings (Settings > Features > MCP > Edit in settings.json):
2. Test It!
Start the Game in Roblox Studio (Press F5 or Play).
Wait for the output:
[MCP Plugin] Plugin Loaded. Polling http://localhost:8081.Ask Cursor:
"Create a bright neon blue part at position 0, 10, 0 named 'TestPart'"
3. Troubleshooting
Issue | Solution |
"Connection Refused" | Ensure the Node server is running. Cursor starts it automatically when you add it to MCP settings. Check Cursor logs if it fails. |
"Timeout" / No Response | Make sure you hit Play in Roblox Studio. The plugin only runs when the game (or plugin script) is running. |
HTTP 403 (Forbidden) | In Roblox Studio, go to Home > Game Settings > Security and enable Allow HTTP Requests. |
"Module not found" | Did you run |