SuperAPI AI 工具集

roblox-studio-mcp

编程与开发

查看项目

更新于 10-15 21:37

技能介绍

用途:Roblox Studio 自带 stdio 的 MCP 服务器,让 AI 智能体在打开的 place 中探索、编辑脚本、在 Edit/Server/Client 上下文运行 Luau、试玩、读取 Output、截取视口并模拟玩家输入,用于验证改动而非猜测。

启用与连接:在最新版 Studio 打开 Assistant → … → Manage MCP Servers,启用 Enable Studio as MCP server。可用 Quick connect(Claude Code、Claude Desktop、Codex CLI、Cursor、Gemini CLI、VS Code、Antigravity)或手动配置。macOS 命令为 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP;Windows 为 cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat。Claude Code 示例:claude mcp add Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP。其他客户端配置见 references/client-setup.md。绿色指示表示连接成功;只连接可信客户端,因其可读写你的 place。

主要工具:Session(list_roblox_studios、get_studio_state,每次调用需 studio_id);Explore(search_game_tree、inspect_instance、script_search、script_grep、script_read);Edit(multi_edit);Run(execute_luau,支持 Edit/Server/Client);Playtest(start_stop_play、get_console_output、screen_capture、character_navigation、user_keyboard_input、user_mouse_input);Assets(search_asset、insert_asset、upload_image、store_image、generate_mesh、generate_material、generate_procedural_model、wait_job_finished);Delegation(subagent);Knowledge(http_get、skill)。

工作循环:先定位 studio_id 与状态,用 search_game_tree 限定深度探索,再 script_grep/script_search 找功能;写前先 script_read 相关脚本及其依赖,并检查是否有 Rojo/Script Sync;用 multi_edit 做精确最小编辑,用 execute_luau(Edit)创建实例/属性/标签;静态复查后试玩,读取控制台错误、驱动场景、在 Server/Client 断言状态、截图,最后务必停止试玩并报告改动与验证情况。

限制与注意:Edit 上下文的 execute_luau 会真实修改 place,探索时优先只读查询,批量改动建议用 ChangeHistoryService 记录以便撤销;试玩期间的改动在停止后丢弃;Rojo 项目以磁盘文件为准,用 multi_edit 改同步脚本会被覆盖,Script Sync 双向同步但勿同时编辑同一脚本;search_game_tree 查询要窄以免输出过大;多窗口需传对 studio_id;从 Creator Store 插入的资产可能含脚本,保留前应检查并移除可疑脚本;无证据不得声称成功。Studio 还通过 skill 工具提供 Roblox 官方技能(如 rbx-debug、rbx-perf-profiling、rbx-scene-analysis、rbx-unit-test、rbx-docs-search、rbx-device-simulator-lua),并有官方流式转换技能 /rbx-convert-to-streaming,使用前先备份 place。