Roblox Studio MCP Server
chrrxs/robloxstudio-mcp
Debug e automação live do Roblox Studio via Claude/Cursor/Gemini
Ver no GitHubServidor MCP que conecta Claude, Cursor ou Gemini diretamente ao Roblox Studio em tempo real, permitindo debug de runtime, controle de playtests multiplayer, capturas de tela, avaliação de código no servidor/cliente e operações em massa em lugares. Oferece 75 ferramentas para inspeção de árvore de arquivos, busca/substituição de scripts, análise de memória e controle completo do ciclo de teste.
Instalação
npx convez-ai chrrxs/robloxstudio-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Debugar e avaliar código Lua em runtime enquanto o jogo está em execução
- Automatizar playtests multiplayer e capturar logs, screenshots e estados
- Refatorar scripts em massa, procurar APIs deprecadas e editar propriedades de objetos
- Inspecionar estrutura de jogo, análise de cena e uso de memória por peer
Veredito

Ferramenta robusta e madura para desenvolvedores Roblox que precisam de automação inteligente dentro do Studio. O suporte a múltiplos clientes IA e os 75 tools cobrem cenários de debug e teste complexos; a documentação é clara e o setup é direto. Recomendado para quem trabalha com projetos Roblox sérios.
README
A tradução para o português deste README ainda está na fila.
Roblox Studio MCP Server
An MCP server for Roblox Studio runtime debugging, playtest automation, and bulk place editing from Claude, Cursor, Codex, or Gemini.
Why this server
Use this when you want your agent to debug and operate a live Roblox Studio session with precise runtime control:
edit,server, andclient-Ntargeting for live playtests.- Game-VM eval on the server or a specific client, sharing the same
requirecache as your scripts. - Explicit StudioTestService multiplayer runs: start, add/remove clients, inspect state, and end.
- Runtime log capture buffers, plus Stats memory and Scene Analysis attribution per peer.
- Viewport screenshots plus virtual mouse, keyboard, character navigation, and UI interaction.
- Bulk property/script/attribute/tag operations for large places.
.rbxmimport/export throughSerializationService.- A read-only inspector package for safer review/debugging sessions.
75 tools total, including file tree inspection, mass reads/writes, script search-and-replace, asset insertion, build import/export, screenshot capture, runtime eval, memory tools, Scene Analysis, and playtest control.
Setup
- Enable Allow HTTP Requests in Game Settings → Security
- Wire up your AI.
@latestfloats the server package to the newest npm release, and--auto-install-plugincopies the matching Studio plugin into Roblox Studio's Plugins folder when the server starts:
# Claude Code
claude mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
# Codex CLI
codex mcp add robloxstudio -- npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
# Gemini CLI
gemini mcp add robloxstudio npx --trust -- -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin
Fully close and reopen Studio after the plugin is first installed or updated. Plugin shows "Connected" when ready.
Prefer manual plugin install? Run npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin.
Custom Plugins folder? Set
MCP_PLUGINS_DIRbefore--auto-install-pluginor--install-plugin. Works on Windows, macOS, and WSL.
If the Studio plugin and MCP server versions differ, the plugin stays connected but shows a yellow warning banner. get_connected_instances, /health, and /status also report pluginVersion, serverVersion, and versionMismatch.
{
"mcpServers": {
"robloxstudio-mcp": {
"command": "npx",
"args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
}
}
}
On Windows, wrap with cmd /c if npx doesn't resolve:
{
"mcpServers": {
"robloxstudio-mcp": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
}
}
}
What you can ask
"What's the structure of this game?" "Find scripts using deprecated APIs and rewrite them." "Start a multiplayer test with 2 clients, read the server log, and tell me why the round never starts." "Evaluate
MatchService.activeMatcheson the server while a match is running." "Spawn 50 NPCs in a 10x5 grid for stress testing."
Inspector edition (read-only)
Same plugin family, different .rbxmx. 35 read-only tools — no writes, no script edits, no creation/deletion. Safe for browsing, code review, and debugging without risk of accidental changes.
Install only one variant at a time. Do not leave both MCPPlugin.rbxmx and MCPInspectorPlugin.rbxmx in the Studio Plugins folder; Studio loads both and they can register duplicate runtime peers. The CLI installers remove the other variant before installing:
npx -y @chrrxs/robloxstudio-mcp-inspector@latest --install-plugin
# Claude / Codex / Gemini — same shape, different package name
claude mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
codex mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
gemini mcp add robloxstudio-inspector npx --trust -- -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
v2.15.2
Building from source
npm install && cd studio-plugin && npm install && cd ..
npm run build # node packages
cd studio-plugin && npm run build && cd .. # plugin TS → Luau
node scripts/build-plugin.mjs # → MCPPlugin.rbxmx
node scripts/build-plugin.mjs --variant inspector # → MCPInspectorPlugin.rbxmx
On WSL the .rbxmx is auto-installed into /mnt/c/Users/<you>/AppData/Local/Roblox/Plugins/, and the local build script removes the other plugin variant from that folder. Set MCP_PLUGINS_DIR to override. Fully close and reopen Studio after a plugin rebuild, and verify only the one variant you intend to test remains in the Plugins folder.
Report Issues · MIT Licensed · Based on boshyxd/robloxstudio-mcp v2.7.0