Skip to main content
Glama
roblox-studio-mcp

roblox-studio-mcp

by iknouee

Roblox Studio MCP Bridge

Connect Kiro (or any MCP-compatible AI assistant) directly to Roblox Studio. Create, read, update, and delete scripts, list instances, execute Luau code, and inspect properties — all through natural language.

Architecture

┌─────────┐       stdio        ┌────────────┐      HTTP       ┌─────────────────┐
│  Kiro   │ ◄──────────────► │  MCP Server │ ◄────────────► │  Relay Server    │
│  (AI)   │                    │  (index.js) │                 │  (relay-server)  │
└─────────┘                    └────────────┘                  └────────┬────────┘
                                                                        │
                                                                   HTTP polling
                                                                        │
                                                               ┌────────▼────────┐
                                                               │  Roblox Studio   │
                                                               │  Plugin (Lua)    │
                                                               └─────────────────┘

Related MCP server: robloxstudio-mcp

Quick Start

# 1. Clone and install
git clone https://github.com/iknouee/roblox-studio-mcp.git
cd roblox-studio-mcp
npm install

# 2. Copy plugin to Roblox Studio plugins folder
# Windows: copy plugin\KiroMCPBridge.server.lua "%LOCALAPPDATA%\Roblox\Plugins\"
# Mac:     cp plugin/KiroMCPBridge.server.lua ~/Documents/Roblox/Plugins/

# 3. Enable HTTP Requests in Studio (Game Settings → Security → Allow HTTP Requests)

# 4. Start the relay server
npm run relay

# 5. Open Roblox Studio — plugin auto-connects!

Available Tools

Tool

Description

create_script

Create a Script, LocalScript, or ModuleScript

read_script

Read the source code of any script

update_script

Update an existing script's source code

delete_script

Delete a script instance

list_instances

List children of any instance (optional recursion)

execute_luau

Run arbitrary Luau code in Studio's plugin context

get_properties

Read properties of any instance

Instance Paths

Scripts and instances are referenced using dot notation:

ServerScriptService.MyScript
ReplicatedStorage.Modules.Utils
Workspace.Map.SpawnPoints
StarterPlayer.StarterPlayerScripts.CameraController
StarterGui.MainUI.Frame.Button

Troubleshooting

Problem

Fix

"Timeout waiting for Studio"

Make sure Studio is open AND relay server is running

Plugin not in toolbar

Re-copy the .lua file and restart Studio

"HTTP Requests are not enabled"

Game Settings → Security → Allow HTTP Requests = ON

npm install fails

Make sure Node.js 18+ is installed

Port 3001 in use

RELAY_PORT=3002 npm run relay

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI coding tools to control Roblox Studio for workspace exploration, instance manipulation, and script management. It provides tools for playtesting, scene rendering, and integration with the Roblox Creator Store.
      6
      10
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to control Roblox Studio by running Luau code, creating and editing instances, reading the scene tree, and managing scripts via an MCP server with a long-polling plugin bridge.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to explore, edit, and automate Roblox Studio sessions locally, including browsing instance hierarchies, reading and modifying scripts, manipulating properties, creating instances, building terrain, and running playtests.
      1,057 npm
      MIT