README.md•1.78 kB
# 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:
```bash
npm install
```
3. Build the server:
```bash
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):
```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. |