2021 Roblox Studio MCP Bridge 🎮🤖

Connect AI coding assistants (OpenCode, Claude Desktop / Claude Code, Cursor, Codex, Windsurf, Gemini CLI, and browser AIs via ZeroScript) directly to 2021 Roblox Studio (Octane / Aisaka) using Anthropic's Model Context Protocol (MCP).

🌟 Features

• screen_capture: Captures high-res screenshots of your Studio viewport/GUI directly into the AI chat.

• execute_luau: Executes arbitrary Luau code in Studio edit mode with automatic ChangeHistoryService undo checkpoints.

• read_script & write_script: Reads and overwrites the full source code of scripts, local scripts, and module scripts.

• script_grep: Global regex search across all scripts in the place.

• inspect_instance: Deep property inspector (CFrames, colors, attributes, tags, children).

• audit_scene_assets: Scans all 3D scene objects (sounds, meshes, decals, particles, clothing) for asset IDs.

• Playtest Suite (run_playtest, start_playtest, stop_playtest): Autonomous AI playtesting with gameplay screenshots and console error diagnostics.

• Stability Suite: HTTP Long-Polling (94% less traffic), Studio heartbeat tracking, infinite-loop guard, and UTF-8 sanitization.

Related MCP server: Roblox Studio MCP

🚀 Quick Setup Guide

✨ NEW: Native Desktop Setup & Control Center App (Octane Studio MCP Setup.exe) Double-click Octane Studio MCP Setup.exe to open the native Windows GUI installer & control center! It includes:

• ⚡ 1-Click Studio Plugin Installer (automatically copies MCPBridge2021.lua into %localappdata%\Roblox\Plugins)

• 📦 Built-in npm install Runner (installs server dependencies right inside the app)

• 🤖 1-Click AI Client Configurator (auto-configures OpenCode, Claude Desktop, Cursor, Windsurf, Claude Code, Codex, and the ZeroScript Browser Extension)

• 🧪 Live Studio Connection Tester (ping 2021 Studio, inspect Workspace, read logs, and test screenshots live)

1. Install the Studio Plugin

1. Open Windows Run (Win + R), type:

   %localappdata%\Roblox\Plugins

   and press Enter.

2. Copy MCPBridge2021.lua into that folder.

3. Open 2021 Roblox Studio (Octane).

4. Check your Output window in Studio; you should see:

   [MCP 2021] Bridge initialized. Connecting to http://127.0.0.1:3021 ...

   (Note: The plugin automatically enables HttpService on launch).

2. Install Dependencies

Open your terminal (PowerShell or Command Prompt) in the repository folder and run:

npm install

🔌 Connect to Your AI Client

Option 1: OpenCode

Add this to opencode.json (or ~/.config/opencode/opencode.jsonc):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "Roblox_2021": {
      "type": "local",
      "command": ["node", "C:/path/to/server.js"],
      "enabled": true
    }
  }
}

Option 2: Claude Desktop

Add this to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "roblox-2021": {
      "command": "node",
      "args": ["C:/path/to/server.js"]
    }
  }
}

Option 3: Cursor

In your project folder, create .cursor/mcp.json (or add in Cursor Settings > Features > MCP):

{
  "mcpServers": {
    "roblox-2021": {
      "command": "node",
      "args": ["C:/path/to/server.js"]
    }
  }
}

Option 4: Codex CLI

Run in your terminal:

codex mcp add roblox-2021 -- node "C:/path/to/server.js"

Option 5: Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "roblox-2021": {
      "command": "node",
      "args": ["C:/path/to/server.js"]
    }
  }
}

Option 6: Claude Code CLI

Run in your terminal:

claude mcp add roblox-2021 -- node "C:/path/to/server.js"

🛠 Available Tools for the AI

📄 License

MIT License