Reaks MCP — Controle de IA para Roblox Studio
Nixera-Studio/reaks-mcp
46 ferramentas MCP para automação de Roblox Studio sem crashes
Ver no GitHubServidor MCP auto-hospedado com 46 ferramentas que fornece controle profundo e estruturado do Roblox Studio via Claude Code. Funciona como daemon HTTP persistente + plugin Rojo em Luau, eliminando travamentos que ocorrem na plataforma Linux/Vinegar. Integra leitura/escrita de propriedades, árvore de instâncias, play-testing, I/O do host e screenshots.
Instalação
npx convez-ai Nixera-Studio/reaks-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
- Automatizar construção e edição de cenas no Roblox Studio via Claude
- Integrar geração procedural de assets com controle em tempo real
- Implementar fluxos CI/CD para games Roblox com validação de instâncias
Veredito

Solução técnica sólida que resolve um problema real do ecossistema Roblox (crashes em Linux). A arquitetura de daemon persistente + ponte HTTP é robusta e bem pensada. Exige familiaridade com Roblox, Luau e MCP para aproveitar os 46 tools de forma efetiva.
README
A tradução para o português deste README ainda está na fila.
✨ Why this exists
The official rbx-studio-mcp ships 6 tools and runs a stdio bridge that is spawned and killed on every client (re)connect. On Linux/Vinegar that churn freezes Studio's synchronous plugin poll → a 30 s ANR → Studio crashes.
Nixera Studio MCP fixes both problems:
- 46 tools — full instance tree, property read/write (real reflection), scripts, play-testing, marketplace inserts, undo/redo, and host file I/O + screenshots.
- A single persistent daemon holds the bridge forever, so the plugin's poll target never dies → Studio never ANR-crashes. Connect/disconnect as much as you like.
- Runs side-by-side with the official server (different port, different plugin) — nothing to uninstall.
🏗 Architecture
One process (reaks-mcp.service, port 44777) serves two surfaces:
| Surface | Path | Who connects |
|---|---|---|
| MCP (streamable HTTP) | http://127.0.0.1:44777/mcp | Claude Code / Codex via --transport http |
| Bridge (long-poll) | /bridge/request · /bridge/response | the in-Studio Luau plugin |
A tool call flows: MCP client → command queue → plugin pops it (long-poll) → runs it in Studio → POSTs the result → returned to the client (each command UUID-correlated to an asyncio.Future). Host tools (files, screenshot) run directly in the daemon and don't touch Studio.
🧰 Tool reference (46)
🔎 Inspect (read-only)
| Tool | Args | Returns |
|---|---|---|
get_studio_mode | – | stop / start_play / run_server |
get_tree | path="game", depth=2 | nested {name, class, children} |
get_instance | path | name, class, full path, parent, child count |
get_children | path | [{name, class, path}] |
get_properties | path, props? | all scriptable props (via API dump) or just the requested ones |
get_property | path, name | a single property value |
search_instances | query, by=name|class|name_regex, root, limit | matching instances |
find_first_child | path, name, recursive? | the child or null |
get_selection | – | currently selected instances |
set_selection | paths[] | sets the Studio selection |
get_place_info | – | PlaceId, GameId, name, version… |
get_services | – | the DataModel services |
✏️ Edit
| Tool | Args | Notes |
|---|---|---|
create_instance | class_name, parent, properties?, name? | values coerced via API dump (Size:[4,1,2]→Vector3) |
set_properties | path, properties | returns {applied, errors} |
delete_instance | path | refuses core services |
rename_instance | path, name | |
move_instance | path, new_parent | reparent |
clone_instance | path, new_parent?, name? | |
call_method | path, method, args? | invoke any instance method; Instance args by path |
get_attributes / set_attribute | path (+name,value) | instance attributes |
get_tags / add_tag / remove_tag | path (+tag) | CollectionService tags |
📜 Scripts
| Tool | Args | Notes |
|---|---|---|
get_script_source | path | live editor buffer if open, else .Source |
set_script_source | path, source | via ScriptEditorService (keeps open tabs in sync) |
create_script | parent, name, kind, source? | Script / LocalScript / ModuleScript |
list_scripts | root="game" | every script + line count |
search_scripts | text, name_only?, regex?, root, limit | grep across all script sources |
▶️ Execute · console · play-test
| Tool | Args | Notes |
|---|---|---|
run_luau | code | runs in edit mode, captures print/warn/returns |
get_console_output | – | recent Output captured since connect |
start_stop_play | mode=start_play|stop|run_server | control play sessions |
run_in_play_mode | code, mode, timeout? | inject + run on the server datamodel, capture logs |
📦 Assets · history
| Tool | Args | Notes |
|---|---|---|
insert_model | query | top free marketplace model → Workspace |
insert_asset | asset_id, parent? | insert by asset id |
undo / redo | – | ChangeHistoryService |
💻 Host machine (runs in the daemon, not Studio)
| Tool | Args | Notes |
|---|---|---|
read_file | path | reads any host file (truncated if huge) |
write_file | path, content | overwrite, creates parent dirs |
append_file | path, content | append text |
list_dir | path="." | [{name, type, size}] |
make_dir | path | mkdir -p |
move_path | src, dst | move / rename |
delete_path | path, recursive? | delete file/dir |
search_files | directory, pattern, regex?, glob? | grep across files |
screenshot | – | captures the Studio window as a PNG |
Reflection:
get_properties/set_properties/create_instanceuse a bundled Roblox API dump (plugin/src/Generated/ApiDump.luau, 884 classes / 2473 properties) for full property enumeration and JSON↔Luau type coercion (Vector3, Color3, CFrame, UDim2, Enum, BrickColor, …). Every mutating tool is wrapped in aChangeHistoryServicerecording, so each AI action is a single, undoable step.
🚀 Install
git clone https://github.com/Nixera-Studio/reaks-mcp
cd reaks-mcp
bash scripts/install.sh
install.sh does it all: installs rojo (cargo), creates the Python venv + deps, downloads the API dump, builds the plugin into the Vinegar prefix, installs & starts the systemd service, and registers the server with Claude Code.
cargo install rojo
python3 -m venv server/.venv && server/.venv/bin/pip install mcp starlette uvicorn pillow
bash scripts/fetch_api_dump.sh
bash scripts/build_plugin.sh
cp systemd/reaks-mcp.service ~/.config/systemd/user/ && systemctl --user enable --now reaks-mcp
claude mcp add --transport http reaks_studio http://127.0.0.1:44777/mcp
▶️ Usage
- The daemon runs persistently —
systemctl --user status reaks-mcp. - Open Roblox Studio. The “Reaks MCP” toolbar button auto-connects; the Output window shows
[ReaksMCP] connected … ready for prompts.(it's an on/off toggle — leave it on; allow the HTTP prompt on first use). - Restart your MCP client once so it loads the tools, then just ask:
“In Studio, create a red Part named Spawn in Workspace, then list every script that mentions DataStore.”
🔧 Maintenance
| Change | Command |
|---|---|
| Edited server tools | systemctl --user restart reaks-mcp + restart the MCP client |
| Edited the plugin | bash scripts/build_plugin.sh + restart Studio |
| Roblox updated / refresh props | bash scripts/fetch_api_dump.sh && bash scripts/build_plugin.sh |
📁 Layout
server/reaks_mcp/ bridge.py · tools.py · fs.py · screenshot.py · __main__.py
plugin/src/ Main · Bridge · Dispatcher · Tools/* · Utils/* · Generated/ApiDump.luau
scripts/ install.sh · build_plugin.sh · fetch_api_dump.sh · gen_api_dump.py
systemd/ reaks-mcp.service
📄 License
MIT © Nixera Studio