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. |