Skip to main content
Glama
deenesjakoruzh
iknouee

roblox-studio-mcp

by iknouee
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Roblox Studio MCP Bridge

Conecta Kiro (o cualquier asistente de IA compatible con MCP) directamente a Roblox Studio. Crea, lee, actualiza y elimina scripts, lista instancias, ejecuta código Luau e inspecciona propiedades, todo mediante lenguaje natural.

Arquitectura

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

Related MCP server: robloxstudio-mcp

Inicio rápido

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

Herramientas disponibles

Herramienta

Descripción

create_script

Crea un Script, LocalScript o ModuleScript

read_script

Lee el código fuente de cualquier script

update_script

Actualiza el código fuente de un script existente

delete_script

Elimina una instancia de script

list_instances

Lista los hijos de cualquier instancia (recursión opcional)

execute_luau

Ejecuta código Luau arbitrario en el contexto de plugin de Studio

get_properties

Lee las propiedades de cualquier instancia

Rutas de instancias

Los scripts y las instancias se referencian mediante notación de puntos:

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

Solución de problemas

Problema

Solución

"Tiempo de espera agotado esperando a Studio"

Asegúrate de que Studio esté abierto y de que el servidor relay esté en ejecución

El plugin no está en la barra de herramientas

Vuelve a copiar el archivo .lua y reinicia Studio

"Las solicitudes HTTP no están habilitadas"

Configuración del juego → Seguridad → Permitir solicitudes HTTP = ON

npm install falla

Asegúrate de que Node.js 18+ esté instalado

El puerto 3001 está en uso

RELAY_PORT=3002 npm run relay

Licencia

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers