🎮 Roblox Studio Ultimate MCP-Server

Englisch | 日本語

Der umfassendste MCP-Server (Model Context Protocol) für Roblox Studio. 41 Tools für die vollständige Studio-Kontrolle aus Claude Code oder jedem MCP-kompatiblen KI-Assistenten.

✨ Warum gibt es das?

Das standardmäßige Roblox Studio MCP bietet nur run_code — was Sie dazu zwingt, Skriptquellen über String-Operationen (gsub) zu manipulieren. Dies führt zu:

❌ Fehlern beim Pattern Matching
❌ Defekten end)-Anweisungen
❌ Stillen Rollbacks, wenn Skripte zurückgesetzt werden
❌ Fehlender Syntaxprüfung vor dem Schreiben
❌ Stunden, die mit einfachen Bearbeitungen verschwendet werden

Dieses MCP löst all das.

🚀 Funktionen

Skript-Operationen (Der Game Changer)

Tool	Beschreibung
`getScript`	Vollständigen Quellcode abrufen
`setScript`	Gesamte Quelle ersetzen (mit Syntaxprüfung + automatischem Backup)
`editScript`	Bestimmten Zeilenbereich bearbeiten (partielle Bearbeitung!)
`insertCode`	Code nach einer bestimmten Zeile einfügen
`removeLines`	Bestimmte Zeilen entfernen
`replaceInScript`	Text suchen & ersetzen (Klartext, sicher)
`getLines`	Nur bestimmten Zeilenbereich abrufen (leichtgewichtig)
`getFunctionList`	Alle Funktionen mit Zeilennummern auflisten
`getScriptSummary`	Übersicht: Funktionen, Requires, Globals
`listScripts`	Alle Skripte im Spiel auflisten
`getAllScripts`	Alle Skriptquellen auf einmal abrufen
`searchInScripts`	Schlüsselwort in allen Skripten suchen
`getReferences`	Alle Verwendungen einer Variable/Funktion finden
`getModuleDependencies`	`require()`-Abhängigkeiten auflisten

Sicherheitsmechanismen

Funktion	Beschreibung
🔒 Syntaxprüfung	Validiert automatisch vor dem Schreiben. Lehnt fehlerhaften Code ab.
💾 Auto-Backup	Speichert die vorherige Version vor jeder Bearbeitung (10 Generationen)
🛑 Play-Modus-Schutz	Blockiert Schreibvorgänge während des Play-Modus (verhindert stille Rollbacks)
📝 UpdateSourceAsync	Nutzt ScriptEditorService für konfliktfreie Schreibvorgänge

Backup & Wiederherstellung

Tool	Beschreibung
`restoreBackup`	Aus automatischem Backup wiederherstellen
`listBackups`	Verfügbare Backups auflisten

Validierung

Tool	Beschreibung
`checkSyntax`	Syntax ohne Schreiben prüfen
`verifyScript`	Zeilenanzahl / Quelllänge verifizieren
`validateAllScripts`	Stapel-Syntaxprüfung für alle Skripte

Instanz-Operationen

Tool	Beschreibung
`getTree`	Instanz-Hierarchie abrufen
`getChildren`	Kinder auflisten (leichtgewichtig)
`getProperty` / `setProperty`	Eigenschaften abrufen/setzen
`createInstance`	Neue Instanz erstellen
`deleteInstance`	Instanz löschen
`cloneInstance`	Instanz klonen
`renameInstance`	Instanz umbenennen
`moveInstance`	Zu anderem Parent verschieben
`findInstances`	Instanzen nach Name/Klasse suchen

Sonstiges

Tool	Beschreibung
`runCode`	Luau-Code ausführen (mit Ausgabe-Erfassung)
`batch`	Mehrere Befehle gleichzeitig ausführen
`getAttribute` / `setAttribute`	Attribut-Operationen
`getErrors` / `clearErrors`	Fehlerprotokoll-Verwaltung
`undo` / `redo`	Rückgängig/Wiederholen-Operationen
`getSelection`	Aktuelle Auswahl abrufen
`getStudioInfo`	Studio-Informationen abrufen

📦 Installation

1. Klonen & Bauen

git clone https://github.com/YOUR_USERNAME/roblox-studio-ultimate-mcp.git
cd roblox-studio-ultimate-mcp
npm install
npm run build

2. Studio-Plugin installieren

Kopieren Sie die Plugin-Datei in Ihren Roblox-Plugins-Ordner:

Mac:

cp plugin/UltimateMCP.rbxmx ~/Documents/Roblox/Plugins/

Windows:

copy plugin\UltimateMCP.rbxmx %LOCALAPPDATA%\Roblox\Plugins\

Oder generieren Sie es aus dem Quellcode:

bash generate-plugin.sh

3. HTTP in Studio aktivieren

Öffnen Sie Roblox Studio und geben Sie in der Befehlszeile (View → Command Bar) Folgendes ein:

game:GetService("HttpService").HttpEnabled = true

4. Bei Claude Code registrieren

Fügen Sie dies in Ihrer ~/.claude.json unter dem entsprechenden Projekt hinzu:

{
  "mcpServers": {
    "roblox_ultimate": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/roblox-studio-ultimate-mcp/dist/index.js"],
      "env": {}
    }
  }
}

5. Neustart

Starten Sie Roblox Studio neu (um das Plugin zu laden)
Starten Sie Claude Code neu (um sich mit dem MCP zu verbinden)

🏗️ Architektur

Claude Code ←(stdio)→ MCP Server (Node.js) ←(HTTP)→ Studio Plugin (Luau)
                         Port 3002

MCP-Server (src/index.ts): Übersetzt MCP-Tool-Aufrufe in HTTP-Befehle
Studio-Plugin (plugin/RobloxMCP.lua): Fragt den Server ab, führt Befehle innerhalb von Studio aus
Kommunikation: HTTP-Polling (300ms Intervall)

🔧 Verwendung mit anderen MCP-Servern

Dieser Server ist so konzipiert, dass er neben dem offiziellen Roblox Studio MCP funktioniert:

Anwendungsfall	Welches MCP
Skript lesen/schreiben	Ultimate (getScript/setScript)
Play-Testing	Offiziell (start_stop_play)
Konsolenausgabe	Offiziell (get_console_output)
Instanzmanipulation	Ultimate
Eigenschaftsänderungen	Ultimate

📝 Auswirkungen in der Praxis

Vor diesem MCP erforderte eine einfache Ein-Zeilen-Korrektur in einem 260-Zeilen-Skript:

run_code, um die Quelle zu erhalten
gsub Pattern Matching (schlägt oft fehl)
run_code, um zurückzuschreiben
Beten, dass es funktioniert
3-5 Mal wiederholen

Jetzt: editScript(path, 103, 103, "neuer Code") → Fertig. Beim ersten Versuch.

🤝 Mitwirken

PRs sind willkommen! Besonders für:

Neue Tools
Bessere Fehlerbehandlung
Leistungsverbesserungen
Dokumentation

📄 Lizenz

MIT

Roblox Studio Ultimate MCP Server