convez.ai
MCP ServerAutomaçãoAvançado
Nixera-Studio

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 GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
0

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:

SurfacePathWho connects
MCP (streamable HTTP)http://127.0.0.1:44777/mcpClaude Code / Codex via --transport http
Bridge (long-poll)/bridge/request · /bridge/responsethe 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)

ToolArgsReturns
get_studio_mode–stop / start_play / run_server
get_treepath="game", depth=2nested {name, class, children}
get_instancepathname, class, full path, parent, child count
get_childrenpath[{name, class, path}]
get_propertiespath, props?all scriptable props (via API dump) or just the requested ones
get_propertypath, namea single property value
search_instancesquery, by=name|class|name_regex, root, limitmatching instances
find_first_childpath, name, recursive?the child or null
get_selection–currently selected instances
set_selectionpaths[]sets the Studio selection
get_place_info–PlaceId, GameId, name, version…
get_services–the DataModel services

✏️ Edit

ToolArgsNotes
create_instanceclass_name, parent, properties?, name?values coerced via API dump (Size:[4,1,2]→Vector3)
set_propertiespath, propertiesreturns {applied, errors}
delete_instancepathrefuses core services
rename_instancepath, name
move_instancepath, new_parentreparent
clone_instancepath, new_parent?, name?
call_methodpath, method, args?invoke any instance method; Instance args by path
get_attributes / set_attributepath (+name,value)instance attributes
get_tags / add_tag / remove_tagpath (+tag)CollectionService tags

📜 Scripts

ToolArgsNotes
get_script_sourcepathlive editor buffer if open, else .Source
set_script_sourcepath, sourcevia ScriptEditorService (keeps open tabs in sync)
create_scriptparent, name, kind, source?Script / LocalScript / ModuleScript
list_scriptsroot="game"every script + line count
search_scriptstext, name_only?, regex?, root, limitgrep across all script sources

▶️ Execute · console · play-test

ToolArgsNotes
run_luaucoderuns in edit mode, captures print/warn/returns
get_console_output–recent Output captured since connect
start_stop_playmode=start_play|stop|run_servercontrol play sessions
run_in_play_modecode, mode, timeout?inject + run on the server datamodel, capture logs

📦 Assets · history

ToolArgsNotes
insert_modelquerytop free marketplace model → Workspace
insert_assetasset_id, parent?insert by asset id
undo / redo–ChangeHistoryService

💻 Host machine (runs in the daemon, not Studio)

ToolArgsNotes
read_filepathreads any host file (truncated if huge)
write_filepath, contentoverwrite, creates parent dirs
append_filepath, contentappend text
list_dirpath="."[{name, type, size}]
make_dirpathmkdir -p
move_pathsrc, dstmove / rename
delete_pathpath, recursive?delete file/dir
search_filesdirectory, pattern, regex?, glob?grep across files
screenshot–captures the Studio window as a PNG

Reflection: get_properties/set_properties/create_instance use 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 a ChangeHistoryService recording, 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

  1. The daemon runs persistently — systemctl --user status reaks-mcp.
  2. 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).
  3. 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

ChangeCommand
Edited server toolssystemctl --user restart reaks-mcp + restart the MCP client
Edited the pluginbash scripts/build_plugin.sh + restart Studio
Roblox updated / refresh propsbash 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

Ver o original no GitHub

Bom para

Relacionados