Skip to main content
Glama
roblox-studio-mcp

roblox-studio-mcp

by iknouee

Roblox Studio MCP Bridge

Verbinde Kiro (oder jeden MCP-kompatiblen KI-Assistenten) direkt mit Roblox Studio. Erstelle, lies, aktualisiere und lösche Skripte, liste Instanzen auf, führe Luau-Code aus und prüfe Eigenschaften — alles über natürliche Sprache.

Architektur

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

Related MCP server: robloxstudio-mcp

Schnellstart

# 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!

Verfügbare Tools

Tool

Beschreibung

create_script

Erstelle ein Script, LocalScript oder ModuleScript

read_script

Lies den Quellcode eines beliebigen Skripts

update_script

Aktualisiere den Quellcode eines vorhandenen Skripts

delete_script

Lösche eine Skript-Instanz

list_instances

Liste die Kinder einer beliebigen Instanz auf (optionale Rekursion)

execute_luau

Führe beliebigen Luau-Code im Plugin-Kontext von Studio aus

get_properties

Lies Eigenschaften einer beliebigen Instanz

Instanzpfade

Skripte und Instanzen werden mithilfe der Punktnotation referenziert:

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

Fehlerbehebung

Problem

Lösung

„Zeitüberschreitung beim Warten auf Studio"

Stelle sicher, dass Studio geöffnet ist UND der Relay-Server läuft

Plugin nicht in der Symbolleiste

Kopiere die .lua-Datei erneut und starte Studio neu

„HTTP-Anfragen sind nicht aktiviert"

Spieleinstellungen → Sicherheit → HTTP-Anfragen erlauben = EIN

npm install schlägt fehl

Stelle sicher, dass Node.js 18+ installiert ist

Port 3001 wird verwendet

RELAY_PORT=3002 npm run relay

Lizenz

MIT

Related MCP Connectors

Related MCP Servers