Roblox Studio MCP

用于 Roblox Studio 的 MCP 服务器。基于推送式桥接提供 29 个工具，所有写入均批量处理且可一步撤销。MIT 许可。

安装

1. Studio 插件

npx -y @el4cteo/rbx-studio-mcp --install-plugin

或者从 Releases 下载 StudioMCP.rbxmx 放入你的 Studio 插件文件夹。

2. 服务器，在你使用的任意客户端中：

claude mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

codex mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

或者在 ~/.codex/config.toml 中：

[mcp_servers.roblox-studio]
command = "npx"
args = ["-y", "@el4cteo/rbx-studio-mcp"]

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）：

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

opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "roblox-studio": {
      "type": "local",
      "command": ["npx", "-y", "@el4cteo/rbx-studio-mcp"],
      "enabled": true
    }
  }
}

claude_desktop_config.json：

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

.vscode/mcp.json：

{
  "servers": {
    "roblox-studio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

~/.gemini/settings.json：

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

~/.codeium/windsurf/mcp_config.json：

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

3. 打开 Studio，接受 127.0.0.1 提示，然后点击 Studio MCP 工具栏按钮。使用 studio_status 验证连接。

4. 对于 debug，在 文件 → Beta 功能 中启用 Debugger Luau API，然后重启 Studio。除调试外，其他功能无需此设置即可工作；需要断点的功能除外，因为只有在启用该功能后 ScriptDebuggerService 才会注册。

默认端口为 44755 — 可通过 --port 或 ROBLOX_STUDIO_MCP_PORT 修改，插件面板中需对应设置。仅监听回环地址。

多个智能体可同时工作。 你可以在任意多个客户端中注册本服务——两个 Claude 会话、Claude 加 Cursor，等等。插件只向外连接一个端口，因此第一个启动的服务器会占用该端口，其余服务器会自动通过它代理。无需额外配置，也不会建立到 Studio 的第二条连接。

每个智能体保留自己的目标：set_active_studio 按 MCP 连接隔离，因此两个智能体可以同时处理两个打开的 place，且互不影响对方的目标。在单次调用中传递 studioId 即可指向其他位置，而无需更改你的默认设置。

隔离是按 MCP 连接进行的，子代理共享其父代理的隔离——这是实测结论，而非假设。子代理调用 set_active_studio 会静默地重新定向其父代理及其兄弟代理：后续调用仍会成功，只是目标已改变。请改为在每次调用中为子代理显式传递 studioId。网络上没有任何信息能区分子代理与其父代理，因此这更多是使用建议，而非服务器可以强制执行的规则。

Related MCP server: Roblox Studio MCP

工具

注意事项：debug 需要在 文件 → Beta 功能 中启用 API 调试器 Lua。device 模拟会持续到 device op="stop" 为止。测试期间会建立两个连接——请显式传递 studioId，并使用编辑会话以确保更改持久化。

批量操作

每个写工具都支持批量操作。编辑十个脚本、删除两百个部件，这些都是一次调用，而不是循环。

modify 的上限是针对条目，而非路径——一个条目可以锚定五百个部件，因此你可以结合 find 在单次调用中修改整个地图。

这样做的额外好处：

• 一次 Ctrl+Z。 整个批次在单个以工具命名的录制中运行。十次脚本编辑只需一步撤销。

• 全有或全无。 所有内容在写入之前都会被检查，因此如果查找失败，则保持 Place 原样不变，而不是部分修改。

• 嵌套。 create 接受 children，因此可以一次性创建完整实例树。新实例的路径无法预先知道，而同名兄弟节点会使得猜测变得不可靠。

多个代理可同时工作——注册此服务器到任意数量的客户端——两个 Claude 会话、Claude 加 Cursor，等等。插件只向外连接一个端口，因此第一个启动的服务器会占用该端口，其余服务器会自动通过它代理。无需额外配置，也不会建立到 Studio 的第二个连接。

每个代理保留自己的目标：set_active_studio 按 MCP 连接隔离，因此两个代理可以同时处理两个已打开的 place，且互不影响。在单次调用中传入 studioId 即可访问其他位置，而无需更改默认目标。

隔离是按 MCP 连接进行的，子代理共享其父代理的隔离——这是经实测验证的，而非假设。子代理调用 set_active_studio 会静默地重新定向其父代理及其兄弟代理：后续调用仍会成功，但针对的是错误的位置。请改为在每次调用中为子代理显式传递 studioId。在线路上无法区分子代理与其父代理，因此这是使用建议，而非服务器可以强制执行的规定。

工具

注意事项：debug 需要在 文件 → Beta 功能 中启用 API 调试器 Luau。device 模拟会持续到 device op="stop" 为止。在 playtest 期间会建立两个会话，请为任何需要持久化的操作显式传递 studioId。

批处理

每个写入工具都接受数组。一次编辑十个脚本、删除两百个部件或一次调用 find 后修改整个场景——一次调用，而非循环。

modify 的限制是 条目 数，而不是路径数——一个条目可以包含任意数量的 paths，因此你可以配合 find 一次修改五百个部件。

与现有方案相比

安全性

绑定 127.0.0.1，拒绝携带 Origin 的请求，并拒绝跨域设置——关闭了 DNS 重绑定漏洞。Studio 按插件和 URL 分别授予 HTTP 权限，因此你体验中的“允许 HTTP 请求”设置不受影响。

开发

npm install
npm run build          # TypeScript -> dist/
npm run build:plugin   # plugin/src -> build/StudioMCP.rbxmx
npm run install:plugin # build + copy into the Studio plugins folder
npm test               # Luau unit tests

需要 Luau 发布版 中的 luau、luau-compile 和 luau-analyze，位于 PATH 或 tools/ 中。

evals/ 包含十个只能通过驱动真实 Studio 会话才能回答的问题——参见 evals/README.md。

许可证

MIT