Roblox Studio MCP Bridge

A Model Context Protocol (MCP) server that connects AI coding assistants like Claude Code directly to Roblox Studio. Read, create, modify, and delete instances in the DataModel — all from your terminal.

How It Works

Claude Code (MCP Client)
        |
   MCP Server (stdio)
        |
   HTTP Bridge (localhost:3001)
        |
   Studio Plugin (polls every 200ms)
        |
   Roblox Studio DataModel

The bridge has two halves:

1. MCP Server (TypeScript) — Runs locally, exposes 14 tools via MCP over stdio, and serves an HTTP API on localhost:3001
2. Studio Plugin (Luau) — Polls the HTTP API for commands, executes them against the DataModel, and returns results

All write operations are wrapped in ChangeHistoryService, so every change can be undone with Ctrl+Z in Studio.

Available Tools

Paths use dot-notation starting from game, e.g. game.Workspace.SpawnLocation.

Prerequisites

• Node.js 18+
• Roblox Studio
• Rojo 7+ (aftman or standalone install)

Installation

1. Clone the repository

git clone https://github.com/Justice219/roblox-studio-mcp.git
cd roblox-studio-mcp

2. Install dependencies and build

npm install
npm run build

Or install directly from npm:

npm install -g @jamesworkbenchcrm/roblox-studio-mcp

3. Build and install the Studio plugin

Using Rojo:

rojo build plugin.project.json -o MCPBridge.rbxmx

Then copy the plugin file to your Roblox plugins folder:

Or build directly to the plugins folder:

# macOS
rojo build plugin.project.json -o ~/Documents/Roblox/Plugins/MCPBridge.rbxmx

# Windows
rojo build plugin.project.json -o "%LOCALAPPDATA%\Roblox\Plugins\MCPBridge.rbxmx"

4. Enable HttpService in Studio

Open Roblox Studio, then:

Home → Game Settings → Security → Allow HTTP Requests → ON

This is required for the plugin to communicate with the local MCP server.

5. Configure your MCP client

Add the server to your MCP client configuration.

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "roblox-studio": {
      "command": "node",
      "args": ["/absolute/path/to/roblox-studio-mcp/dist/index.js"]
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "roblox-studio": {
      "command": "node",
      "args": ["/absolute/path/to/roblox-studio-mcp/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/ with the actual path where you cloned the repo.

6. Restart Studio and your MCP client

• Restart Roblox Studio (or reload plugins) — you should see an "MCP Bridge" button in the toolbar
• Restart Claude Code / your MCP client
• The plugin status w

... View full README on GitHub