Roblox Studio MCP

Servidor MCP para Roblox Studio. 29 herramientas sobre un puente push-based, cada escritura se agrupa en lotes y se puede deshacer en un solo paso. MIT.

Instalación

1. El plugin de Studio

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

O descarga StudioMCP.rbxmx desde Releases en tu carpeta de plugins de Studio.

2. El servidor, en el cliente que uses:

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

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

O en ~/.codex/config.toml:

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

~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "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. Abre Studio, acepta el aviso de 127.0.0.1, revisa el botón de la barra de herramientas Studio MCP. Verifica con studio_status.

4. Para debug, activa Debugger Luau API en Archivo → Funciones Beta y reinicia Studio. Todo lo demás funciona sin esto; los puntos de interrupción no, porque ScriptDebuggerService no se registra hasta que se activa.

El puerto por defecto es 44755 — --port o ROBLOX_STUDIO_MCP_PORT, coincidente con el widget del plugin. Solo loopback.

Varios agentes a la vez funcionan. Regístralo en tantos clientes como quieras — dos sesiones de Claude, Claude más Cursor, lo que sea. El plugin se conecta a un puerto, así que el primer servidor que arranque lo toma y el resto se conecta a través de él automáticamente. No hay nada que configurar, y no hay una segunda conexión a Studio.

Cada agente mantiene su propio objetivo: set_active_studio se vincula por cliente, así que dos agentes pueden trabajar en dos lugares abiertos a la vez y ninguno puede reorientar al otro. Pasa studioId en una llamada individual para llegar a otra parte sin cambiar tu valor por defecto.

El aislamiento es por conexión MCP, y los subagentes comparten el de su padre — medido, no asumido. Un subagente que llame a set_active_studio reorienta a su padre y a sus hermanos, y las llamadas se siguen ejecutando, solo que contra el lugar equivocado. Pasa un studioId explícito por llamada en su lugar. Nada en la conexión distingue a un subagente de su padre, así que esto es una directriz, no algo que el servidor pueda imponer.

Related MCP server: Roblox Studio MCP

Herramientas

Advertencias: debug necesita API debugger Luau en Archivo → Funciones beta. La emulación de device persiste hasta device op="stop". Durante una prueba de juego, pasa studioId explícitamente, usando la sesión de edición para todo lo que deba persistir.

Lotes

Cada herramienta de escritura acepta un lote, y cada lote es una sola acción.

El límite en modify es de 100 entradas, no de objetivos — una entrada puede anclar y cambiar varios elementos. Los límites no son sobre el tamaño del mundo; son para proteger sesiones de Studio con mucha actividad en red.

Un Ctrl+Z. El lote se ejecuta dentro de una única grabación de ChangeHistoryService con el nombre de la herramienta. Diez ediciones de scripts se deshacen en un paso, no en diez.

Todo o nada. Cualquier error, ya sea de validación o de ejecución, deja el lugar sin tocar. No verás un cambio a medias si una herramienta falla a mitad de camino.

Anidamiento. create y script_create aceptan árboles completos en una sola llamada, se llamen o no los hijos. El orden de las operaciones dentro de una llamada está garantizado, y las llamadas paralelas reciben sus propias respuestas.

Cómo se compara con lo que existe

Seguridad

Se enlaza a 127.0.0.1, rechaza solicitudes con Origin y exige un encabezado que el navegador no puede configurar entre orígenes — cerrando el agujero de DNS-rebinding. Studio concede HTTP por experiencia, así que la configuración de "Allow HTTP Requests" de tu experiencia no se toca.

Desarrollo

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

Requiere luau, luau-compile y luau-analyze de los releases de Luau.

evals/ contiene once preguntas que solo pueden responderse conduciendo una sesión real de Studio — ver evals/README.md.

Licencia

MIT.