Roblox Studio MCP Assistant - Quick Start

1. Installation

Step A: Setup Node Server

1. Open terminal in this folder (C:/Desktop/roblox-studio-mcp-server-V1).
2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

Step B: Install Roblox Plugin

1. Copy the file plugin/loader.server.lua from this folder.
2. Open Roblox Studio.
3. Right-click ServerScriptService in the Explorer -> Paste into.
4. (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):

{
  "roblox-studio": {
    "command": "node",
    "args": [
      "C:\\PATH-TO-roblox-studio-mcp-server-V1\\dist\\index.js"
    ]
  }
}

2. Test It!

1. Start the Game in Roblox Studio (Press F5 or Play).
2. Wait for the output: [MCP Plugin] Plugin Loaded. Polling http://localhost:8081.
3. 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 npm install and npm run build? Check the dist folder exists.