Skip to main content
Glama
deenesjakoruzh
jundayoo

Roblox Studio Ultimate MCP Server

by jundayoo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

🎮 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.

Related MCP server: Melo

🚀 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:

  1. run_code, um die Quelle zu erhalten

  2. gsub Pattern Matching (schlägt oft fehl)

  3. run_code, um zurückzuschreiben

  4. Beten, dass es funktioniert

  5. 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityNo data
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers

  • Melo

    yannyhl
    A
    license
    Not graded
    quality
    D
    maintenance
    An agentic MCP server for Roblox Studio that provides over 45 tools for script diffing, playtest automation, and bulk instance manipulation. It enables AI agents to manage full development cycles within Roblox, including transaction-safe batch operations and real-time script reviews.
    2 npm
    1
    MIT