使用说明

Roblox Studio MCP服务器

将AI助手连接到Roblox Studio——51个用于探索、编辑和自动化游戏的工具。

使用 克劳德代码, 克劳德桌面版, 光标, 双子座, 法典，以及任何兼容MCP的客户端。

它的作用

MCP（模型上下文协议）服务器，使AI能够完全访问您的Roblox Studio会话。探索游戏层次结构，阅读和编辑脚本，操纵属性，创建实例，构建地形，运行游戏测试——所有这些都是通过HTTP轮询在本地进行的。没有外部服务器，没有数据收集。

快速开始

1.安装Studio插件

选项A——创建者商店（最简单）： 从Roblox Creator商店安装

选项B——手动： 下载 MCPPlugin.rbxmx 从发布并将其放入您的插件文件夹中：

窗户： %LOCALAPPDATA%/Roblox/Plugins/
macOS： ~/Documents/Roblox/Plugins/

2.启用HTTP请求

游戏设置 > 安全 > 允许HTTP请求 =打开

3.连接你的AI

克劳德代码：

claude mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

食品法典：

codex mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

双子座：

gemini mcp add robloxstudio npx --trust -- -y robloxstudio-mcp@latest

Claude Desktop, Cursor, Windsurf, or other MCP clients

添加到MCP配置文件中：

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "robloxstudio-mcp@latest"]
    }
  }
}

windows用户 --如果遇到问题，请使用 cmd:

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "robloxstudio-mcp@latest"]
    }
  }
}

插件显示 “已连接” 当准备好。

51工具

探索与查询（10）

工具	说明
`get_file_tree`	以树的形式浏览实例层次结构
`search_files`	按名称、类或脚本内容搜索实例
`get_place_info`	获取地点ID、名称和游戏设置
`get_services`	列出可用的Roblox服务
`search_objects`	按名称、类或属性查找实例
`search_by_property`	查找具有特定属性值的实例
`get_instance_properties`	获取实例的所有属性
`get_instance_children`	按班级类型列出孩子
`get_class_info`	获取类的可用属性/方法
`get_project_structure`	具有可配置深度的完整层次结构

实例管理（8）

工具	说明
`create_object`	创建新实例
`create_object_with_properties`	创建具有初始属性的实例
`mass_create_objects`	批量创建实例
`mass_create_objects_with_properties`	使用属性批量创建
`delete_object`	删除实例
`smart_duplicate`	命名、定位、属性变化重复
`mass_duplicate`	一次执行多个复制操作
`reparent_instance`	将实例移动到新的父级（无需删除/重新创建）

克隆与资产（2）

工具	说明
`clone_instance`	将实例深度复制到其他父级
`insert_asset`	按ID插入Roblox资源（模型、网格、图像）

房产（5）

工具	说明
`set_property`	在实例上设置任何属性
`mass_set_property`	在多个实例上设置相同的属性
`mass_get_property`	从多个实例读取同一属性
`set_calculated_property`	通过数学公式设置属性
`set_relative_property`	修改相对于当前值的属性

脚本（6）

工具	说明
`get_script_source`	读取脚本源代码（支持行范围）
`set_script_source`	替换整个脚本源
`edit_script_lines`	替换特定线路
`insert_script_lines`	在某个位置插入线条
`delete_script_lines`	删除特定行
`search_replace_scripts`	在所有脚本中查找/替换文本

UI大楼（1）

工具	说明
`create_ui`	批量创建具有适当UDim2大小的UI元素

地形（4）

工具	说明
`fill_terrain`	用地形材料填充矩形区域
`fill_terrain_sphere`	用材料填充球形区域
`clear_terrain`	地形清晰（区域或全部）
`get_terrain_materials`	列出可用的地形材料

属性和标签（8）

工具	说明
`get_attribute` / `set_attribute`	读/写实例属性
`get_attributes`	获取实例上的所有属性
`delete_attribute`	删除属性
`get_tags` / `add_tag` / `remove_tag`	管理CollectionService标签
`get_tagged`	查找具有特定标记的所有实例

撤消/重做（2）

工具	说明
`undo`	撤消上一个操作（Ctrl+Z）
`redo`	恢复上次未执行的操作（Ctrl+Y）

代码执行与播放测试（5）

工具	说明
`execute_luau`	在Studio中运行任意Luau代码
`get_selection`	获取当前选定的对象
`start_playtest`	通过日志捕获启动播放/运行会话
`stop_playtest`	停止会话并返回输出
`get_playtest_output`	不停止轮询日志

建筑

AI Assistant <--stdio--> MCP Server (Node.js)
                            <--HTTP--> Bridge (Express on port 58741)
                                          <--polling--> Studio Plugin (roblox-ts)
                                                           <--API--> Roblox Studio

无状态HTTP网桥 使用UUID跟踪请求
500ms轮询 --可靠，无WebSocket复杂性
30秒超时 根据要求
变更历史服务 集成——每个突变都会创建一个撤销航路点
所有本地 --什么都不会离开你的机器

发展

npm install                  # Install dependencies
npm run build:all            # Build server + plugin
npm run dev                  # Dev mode with tsx
npm test                     # Run tests
npm run build:plugin         # Rebuild Studio plugin only

故障排除

问题	修复
工具栏中缺少插件	验证 `.rbxmx` 位于Plugins文件夹中，请重新启动Studio
HTTP 403错误	在游戏设置>安全中启用“允许HTTP请求”
插件显示“已断开连接”	在MCP服务器运行之前正常-启动您的AI客户端
连接超时	检查防火墙是否未阻止本地主机：58741

许可证

麻省理工学院

报告问题