Connects MCP clients to Roblox Studio's edit context and live server/client VMs. Agents can modify places, run Luau inside active playtests with the same module state as game scripts, automate solo...
概览
Connects MCP clients to Roblox Studio's edit context and live server/client VMs. Agents can modify places, run Luau inside active playtests with the same module state as game scripts, automate solo...
README
Roblox Studio MCP
Connects MCP clients to Roblox Studio’s edit context and live server/client VMs. Agents can modify places, run Luau inside active playtests with the same module state as game scripts, automate solo and multiplayer sessions, and collect per-peer logs, screenshots, and profiler data.
Tool overview
Runtime debugging
eval_server_runtime/eval_client_runtime: run Luau in a server or client game VM with the samerequirecache as game scripts.breakpoints: instrument live code and record execution without pausing the playtest.get_runtime_logs: capture logs per peer (edit,server,client-N), including boot-time output and structuredLogServicedata.
Playtest automation
solo_playtest/multiplayer_playtest: start, inspect, and stop solo or multi-client playtests.manage_instance: launch, inspect, and close Studio windows for baseplates, local files, published places, or place revisions.
Profiling & performance
capture_script_profiler/capture_micro_profiler: capture CPU timings on the server or a client.get_memory_breakdown/get_scene_analysis: report memory and scene attribution per peer.
Editing
execute_luau: run Luau in Studio’s edit context and return its output.mass_set_property,bulk_set_attributes,find_and_replace_in_scripts: update properties, attributes, or script text in bulk.capture_screenshotand input tools: capture the viewport and send mouse or keyboard input.
Creator Store asset workflow
search_assets: search public assets; useget_asset_detailsto retrieve full metadata.preview_asset: inspect an unparented asset’s hierarchy, media metadata, and security scan.insert_asset: remove scripts and package links, verify the result, and parent it in Studio.
Agent guidance
get_roblox_docs: fetch official engine API documentation as Markdown.get_roblox_skills: list and retrieve Roblox-authored skills.
…and much more. Review all tools here.
Setup
- Wire up your AI.
--auto-install-plugininstalls the matching Studio plugin automatically:
# 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. The plugin shows Connected when ready.
Multiple open places connect to the same server; call get_connected_instances and pass instance_id to route tool calls. Custom Plugins folder: set MCP_PLUGINS_DIR. Manual plugin install: npx -y @chrrxs/robloxstudio-mcp@latest --install-plugin.
Inspector edition (read-only)
39 read-only tools: no writes, no script edits. Safe for browsing, code review, and debugging without risk of accidental changes. Install only one variant at a time (the installers remove the other automatically):
claude mcp add robloxstudio-inspector -- npx -y @chrrxs/robloxstudio-mcp-inspector@latest --auto-install-plugin
More
- Configuration and HTTP bridge
- Creator Store asset workflow
- Report a security vulnerability
- Building from source
- Deprecated tool names
v2.23.1
Report Issues · MIT Licensed · Based on boshyxd/robloxstudio-mcp v2.7.0
安装
npx -y @chrrxs/robloxstudio-mcp@latest --auto-install-plugin配置
{
"mcpServers": {
"robloxstudio-mcp": {
"command": "npx",
"args": ["-y", "@chrrxs/robloxstudio-mcp@latest", "--auto-install-plugin"]
}
}
}