用途:roblox-mcp 指 Roblox Studio 内置的官方 Model Context Protocol(MCP)服务器,让 AI 客户端连接当前打开的 place,进行检查与编辑。它采用 stdio 传输,作为本地进程把客户端请求代理进活动的 Studio 会话。Script Sync 负责磁盘到 Studio 的文件同步,MCP 负责其余部分:资源管理器选择、实例检查、脚本编辑、Luau 执行、试玩模式、输入模拟和资产插入。
主要能力:工具按类别划分,包括脚本(script_read、multi_edit、script_search、script_grep)、数据模型(search_game_tree、inspect_instance)、Luau 执行(execute_luau)、资产生成与插入(generate_mesh、search_asset、insert_asset 等)、试玩(start_stop_play、get_studio_state、get_console_output、screen_capture)、输入模拟(character_navigation、user_keyboard_input、user_mouse_input)、文档、以及实例发现(list_roblox_studios)。
使用方式:需要最新版 Roblox Studio、已登录的 Roblox 账号、以及支持 stdio 的 MCP 客户端(Cursor、VS Code + Claude Code、Claude Desktop、Codex CLI、Gemini CLI、Antigravity 等)。在 Studio 中打开 Assistant → ⋯ → Manage MCP Servers,开启 Enable Studio as MCP server,再用 Quick connect 或手动配置连接客户端,必要时重启客户端。多窗口场景先调用 list_roblox_studios,之后在每次调用中传入所选实例的 studio_id。验证可让 MCP 读取 Workspace 游戏树,或用 execute_luau 运行简单 print。
局限与安全:MCP 客户端可读写已打开的 place,应只连接可信客户端,在测试场景或版本控制项目中操作,发布前审查代理改动,不使用时断开或关闭服务器。execute_luau 属特权代码,可发布 place、写入 DataStore、发起 HTTP 请求并访问 Studio 中的凭据。具体 per-OS 配置命令、工具完整参数和故障排查步骤,资料指向 references 下的文档,此处暂未提供。