Roblox Studio MCP

MCP-Server für Roblox Studio. 29 Tools über eine Push-basierte Brücke, jeder Schreibvorgang wird gebündelt und ist in einem Schritt rückgängig zu machen. MIT.

Installation

1. Das Studio-Plugin

npx -y @el4cteo/rbx-studio-mcp --install-plugin

Oder lade StudioMCP.rbxmx von Releases in deinen Studio-Plugins-Ordner herunter.

2. Den Server, in welchem Client auch immer du verwendest:

claude mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

codex mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

Oder in ~/.codex/config.toml:

[mcp_servers.roblox-studio]
command = "npx"
args = ["-y", "@el4cteo/rbx-studio-mcp"]

~/.cursor/mcp.json (global) oder .cursor/mcp.json (pro Projekt):

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "roblox-studio": {
      "type": "local",
      "command": ["npx", "-y", "@el4cteo/rbx-studio-mcp"],
      "enabled": true
    }
  }
}

claude_desktop_config.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "roblox-studio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

~/.gemini/settings.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

3. Öffne Studio, akzeptiere die 127.0.0.1-Aufforderung, prüfe die Studio-MCP-Toolbar-Schaltfläche. Verifiziere mit studio_status.

4. Für debug, aktiviere Debugger-Luau-API unter Datei → Beta-Funktionen und starte Studio dann neu. Alles andere funktioniert ohne diese Einstellung; Haltepunkte jedoch nicht, da ScriptDebuggerService erst registriert wird, wenn diese aktiviert ist.

Der Port ist standardmäßig 44755 — --port oder ROBLOX_STUDIO_MCP_PORT, abgeglichen im Plugin-Widget. Nur Loopback.

Mehrere Agents gleichzeitig funktionieren. Registriere dies in so vielen Clients, wie du möchtest — zwei Claude-Sitzungen, Claude plus Cursor, was auch immer. Das Plugin verbindet sich ausgehend zu einem Port, sodass der erste gestartete Server ihn besitzt und der Rest automatisch über ihn proxied. Nichts zu konfigurieren und keine zweite Verbindung zu Studio.

Jeder Agent behält sein eigenes Ziel: set_active_studio bindet pro Client, sodass zwei Agents gleichzeitig an zwei geöffneten Orten arbeiten können und keiner das Ziel des anderen umstellen kann. Übergib studioId bei einem einzelnen Aufruf, um woanders hinzugelangen, ohne deinen Standard zu ändern.

Die Isolierung erfolgt pro MCP-Verbindung, und Subagents teilen die ihres Parents — gemessen, nicht angenommen. Ein Subagent, der set_active_studio aufruft, stellt das Ziel seines Parents und seiner Geschwister still um: Spätere Aufrufe gelingen weiterhin, nur gegen den falschen Ort. Gib Subagents stattdessen pro Aufruf eine explizite studioId. Nichts auf der Leitung unterscheidet einen Subagent von seinem Parent, daher ist dies eine Empfehlung und keine vom Server durchsetzbare Regel.

Related MCP server: Roblox Studio MCP

Tools

Stolperfallen: debug benötigt API-Debugger-Luau unter Datei → Beta-Funktionen. Die device-Emulation bleibt bestehen, bis device op="stop" ausgeführt wird. Während eines Playtests verbinden sich zwei Sitzungen — übergib studioId explizit und verwende die Bearbeitungssitzung für alles, was persistent bleiben muss.

Batching

Jedes Schreib-Tool akzeptiert ein Array. Zehn Skripte bearbeiten, zweihundert Teile löschen oder eine ganze Karte verankern ist ein Aufruf, keine Schleife.

Die Obergrenze bei modify bezieht sich auf Einträge, nicht auf Ziele — ein Eintrag kann fünfhundert Teile verankern, kombiniere ihn also mit find und ändere einen ganzen Ort in einem einzigen Aufruf.

Was das über Geschwindigkeit hinaus bringt:

• Ein Strg+Z. Der Batch läuft innerhalb einer einzigen ChangeHistoryService-Aufzeichnung, die nach dem Tool benannt ist. Zehn Skriptbearbeitungen machen sich als ein Schritt rückgängig, nicht als zehn.

• Alles oder nichts. Alles wird im Speicher gelesen und transformiert, bevor etwas geschrieben wird, sodass ein find, das nichts findet — oder doppelt findet — mit unberührtem Ort fehlschlägt, statt halb bearbeitet zu sein.

• Verschachtelung. create akzeptiert children, sodass ein ganzes Modell in einem Aufruf ankommt. Der Pfad einer neuen Instanz ist erst bekannt, wenn sie existiert, und gleichnamige Geschwister machen das Raten unzuverlässig.

Parallele Tool-Aufrufe funktionieren ebenfalls — Antworten sind nach Anfrage-ID sortiert, sodass mehrere Aufrufe in einer Runde gleichzeitig laufen. Bevorzuge einen Batch, wo einer existiert: Parallele Aufrufe sind N Roundtrips und N Undo-Schritte, ein Batch ist je einer davon.

Im Vergleich zu dem, was sonst existiert

• Push, nicht Poll. SSE-Stream statt eines 500-ms-Polls. 50 sequenzielle Roundtrips: 13,6 ms Mittelwert vs. 25,8 ms, 12,8 ms Median vs. 29,9 ms. Reproduzierbar mit node scripts/latency.mjs --count 50 --compare.

• Sichere Skriptbearbeitungen. ScriptEditorService:UpdateSourceAsync, nicht script.Source — dein ungespeicherter Editor-Puffer überlebt.

• Ein Strg+Z pro Aktion, über ChangeHistoryService.

• 29 Tools, ~16k Tokens Schema, gegenüber 43–51 anderswo. Cursor-paginiert, begrenzt, mit detail: concise | standard | full.

• Live-API-Dump zur Eigenschaftsvalidierung, sodass Tippfehler Vorschläge erhalten (Anchorred → Anchored).

• Mehrere Agents, ein Studio, jeder mit eigenem Ziel — keine ID bei jedem Aufruf nötig und kein Agent kann das Ziel eines anderen umstellen. Der eingebaute Server erreicht dieselbe Isolierung, indem er studio_id überall verpflichtend macht und set_active_studio entfernt; dieses hier behält den Standard, sodass ein einzelnes geöffnetes Studio gar keine ID benötigt.

Nicht hier gebaut: Terrain, KI-Mesh- und Materialgenerierung.

Sicherheit

Bindet an 127.0.0.1, lehnt Anfragen mit Origin ab und verlangt einen Header, den ein Browser nicht Cross-Origin setzen kann — schließt das DNS-Rebinding-Loch. Studio gewährt HTTP pro Plugin und pro URL, sodass die Einstellung „HTTP-Anfragen zulassen" deines Erlebnisses unberührt bleibt.

Entwicklung

npm install
npm run build          # TypeScript -> dist/
npm run build:plugin   # plugin/src -> build/StudioMCP.rbxmx
npm run install:plugin # build + copy into the Studio plugins folder
npm test               # Luau unit tests

Benötigt luau, luau-compile und luau-analyze aus den Luau-Releases auf PATH oder in tools/.

evals/ enthält zehn Fragen, die nur durch das Steuern einer echten Studio-Sitzung beantwortet werden können — siehe evals/README.md.

Lizenz

MIT.