AB
AB
AiBoss站

全部分类

project

roblox-studio-mcp - 把 AI 编程助手接入 Roblox Studio 的 MCP 服务端

roblox-studio-mcp 是一个用 Node.js/TypeScript 实现的 Model Context Protocol 服务端，据项目自述，它把 Claude Desktop、Cursor、Cline 等 AI 客户端与 Roblox Studio 连接起来，让模型读取对象树、读写 Lua 脚本、查看与修改属性并控制 playtest。项目由 HerdBuilderEstimate 维护，采用 MIT 许可证，截至 2026-11-08 获得 428 星标，尚无正式 release。

roblox-studio-mcp 是一个面向 Roblox Studio 的 Model Context Protocol（MCP）服务端实现。按项目自述，它用 Node.js 与 TypeScript 编写，充当 AI 编程助手与 Roblox Studio 之间的桥梁：一端通过 MCP 协议对接 Claude Desktop、Cursor、Cline 等支持该协议的客户端，另一端通过 WebSocket 与 Studio 内的 Lua 插件通信，从而让模型能够读取游戏的对象层级、生成和修改 Lua 脚本、检查实例属性，并触发 playtest。它适合已经在使用 MCP 兼容 AI 客户端的 Roblox 开发者，尤其是希望把重复性的脚本编写与场景检查交给代理执行、同时又不愿离开编辑器的人。

维护者与状态

该项目由 HerdBuilderEstimate 维护，仓库创建于 2026-11-06，最后一次提交同样在 2026-11-06，属于非常新的项目。事实表显示，截至 2026-11-08，仓库获得 428 个星标，且尚无正式 release——也就是说目前没有可引用的版本号或发布说明，使用者只能跟随仓库主分支的代码状态。项目采用 MIT 许可证。

需要提醒的是，创建与最后提交时间集中在同一天，加上没有正式发布记录，意味着接口与配置方式仍可能变动；在把它接入日常工作流之前，建议先确认仓库当前的实际状态。

主要能力

以下能力均来自项目 README 的自述，未经独立验证：

  • MCP 协议支持：README 称其兼容 Claude Desktop、Cursor IDE、Cline 与 ChatGPT（后者通过适配器接入）。
  • 对象树读取：可浏览当前 place 的完整层级结构，对应工具 get_object_tree；也可按路径获取单个实例的详情，对应 get_instance。
  • Lua 脚本读写：通过 create_script 在指定父路径下新建脚本，通过 update_script 替换已有脚本的源码。
  • 属性检查与修改：get_properties 读取任意实例属性，set_property 修改属性值。
  • Playtest 控制：run_playtest 与 stop_playtest 让代理直接启动或停止试运行。
  • 只读安全模式：开启后禁用破坏性操作，README 说明 delete_instance 在安全模式下不可用。
  • 自动发现会话：据项目说明，服务端能自动找到已打开的 Studio 会话，因此可同时对接多个 Studio 实例。
  • 轻量实现：技术栈为 TypeScript、Node.js，通信使用 WebSocket 与 stdio，插件侧为 Lua。

项目在 README 中强调「安全设计」：不执行不受信任的代码、不做内存操作、不访问私有数据，所有操作都被限制在 Studio 插件沙箱内。这属于维护者的自我描述，实际边界仍应以代码与许可证为准。

使用入口

仓库地址为 roblox-studio-mcp，安装与配置说明以仓库内文档为准。

据 README，接入 Claude Desktop 或 Cursor 的方式是在 claude_desktop_config.json（或 Cursor 的 MCP 设置）中加入一段服务端配置，命令通过 npx 拉起：

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "roblox-studio-mcp"]
    }
  }
}

保存后重启 AI 助手，即可用自然语言要求代理读取对象树等。README 还列出了若干环境变量用于调整行为：RBX_MCP_PORT（WebSocket 端口，默认 44755）、RBX_MCP_SAFE_MODE（设为 true 关闭破坏性操作）、RBX_MCP_LOG_LEVEL（debug / info / warn / error）以及 RBX_MCP_TIMEOUT（请求超时毫秒数）。

注意：素材中出现的下载压缩包、运行可执行文件并「注入脚本」的快速开始步骤，与项目自述的「不执行不受信任代码」定位相互矛盾，且与 MCP 服务端通过 npx 启动的常规方式不符。本文不转述该流程，请以仓库中的实际安装说明为准。

许可与限制

许可证为 MIT，按事实表原样记录。README 同样写明 MIT License，称可自由使用、修改与再分发。

使用边界方面，项目自述提到几点前置条件：使用者必须对目标 place 拥有编辑权限；客户端需要支持 MCP 协议，README 称免费模型也可用，只要客户端兼容；多实例场景下建议开启 RBX_MCP_SAFE_MODE=true 做只读探索。此外，项目没有正式 release，也没有公开的版本兼容矩阵或性能数据，README 中「低内存占用」「快速轻量」等表述属于维护者自述，没有给出可核对的指标。对于需要稳定版本号的生产流程，建议先评估这一状态再决定是否采用。

返回