Roblox Studio Mcp Server [official]

警告

此 MCP 服务已不再积极开发

我们已将持续的工程投入转向 Roblox Studio 内置的 MCP 服务，并推荐将其作为今后连接外部 AI 工具的最佳方式。

此服务的源代码和先前版本仍会保留在此处，供参考并支持现有工作流。

快速设置

1. 下载并运行服务：Windows 或 macOS
2. 重启 AI 客户端（Claude、Cursor 等）和 Roblox Studio
3. 完成！

Roblox Studio MCP 服务

此代码仓库包含模型上下文协议（MCP）的参考实现，可通过插件在 Roblox Studio 与 Claude Desktop 或 Cursor 之间进行通信。 它由以下基于 Rust 的组件组成，这些组件通过内部共享对象进行通信。

• 基于 axum 构建的 Web 服务，Studio 插件会对其进行长轮询。
• 通过 stdio 传输与 Claude 通信的 rmcp 服务。

当大模型请求运行工具时，插件会通过长轮询收到请求，并发送响应。这会使响应传送到 Claude 应用。

请注意，此 MCP 服务可由第三方工具访问，使其能够修改和读取已打开场景的内容。第三方的数据处理和隐私惯例受其各自的条款和条件约束。

设置过程还包含一个小型插件安装程序和 Claude Desktop 配置脚本。

包含的工具

• run_code - 在 Roblox Studio 中运行命令并返回打印的输出。可用于进行更改和获取信息。
• insert_model - 将模型从 Roblox Creator Store 插入工作区。返回已插入模型的名称。
• get_console_output - 获取 Roblox Studio 的控制台输出。
• start_stop_play - 启动或停止播放模式，或运行服务器。
• run_script_in_play_mode - 在播放模式下运行脚本，并在脚本完成或超时后自动停止播放。返回包含日志、错误和持续时间的结构化输出。
• get_studio_mode - 获取当前 Studio 模式（start_play、run_server 或 stop）。

设置

使用发行版二进制文件安装

此 MCP 服务几乎支持任何 MCP 客户端，但仅会在检测到 Claude Desktop 和 Cursor 时自动进行设置。

要自动设置：

1. 确保已安装并至少启动过一次 Roblox Studio 和 Claude Desktop/Cursor。
2. 如果 MCP 客户端和 Roblox Studio 正在运行，请退出。
3. 下载并运行安装程序：
   1. 前往 发行版 页面，下载适用于你平台的最新版本。
   2. 如有需要，解压下载的文件并运行安装程序。
   3. 如果 Claude/Cursor 和 Roblox Studio 正在运行，请重启它们。

手动设置

要手动设置，请将以下内容添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "Roblox_Studio": {
      "args": [
        "--stdio"
      ],
      "command": "Path-to-downloaded\\rbx-studio-mcp.exe"
    }
  }
}

在 macOS 上，如果将应用移至 Applications 目录，路径可能类似于 "/Applications/RobloxStudioMCP.app/Contents/MacOS/rbx-studio-mcp"。

对于 Claude Desktop，请前往 Settings > Developer > Edit Config。此操作会打开 claude_desktop_config.json 所在的位置。

某些客户端要求用户为每个项目手动设置 MCP 服务。 例如，Claude Code 命令如下：

claude mcp add --transport stdio Roblox_Studio -- '/Applications/RobloxStudioMCP.app/Contents/MacOS/rbx-studio-mcp' --stdio

从源代码构建

要从此代码库的源代码构建并安装 MCP 参考实现：

1. 确保已安装并至少启动过一次 Roblox Studio 和 Claude Desktop。
2. 如果 Claude 和 Roblox Studio 正在运行，请退出。
3. 安装 Rust。
4. 下载或克隆此代码库。
5. 在此代码库的根目录中运行以下命令。

   cargo run
   

   此命令会执行以下操作：
   • 构建 Rust MCP 服务应用。
   • 配置 Claude，使其能够与 MCP 服务通信。
   • 构建并安装 Studio 插件，使其能够与 MCP 服务通信。

命令完成后，Studio MCP 服务即安装完毕，可随时接收来自 Claude Desktop 的提示词。

验证设置

按照以下步骤确保一切设置正确：

1. 在 Roblox Studio 中，点击 Plugins 选项卡，确认 MCP 插件已显示。点击图标可开启或关闭与 Claude Desktop 的 MCP 通信，你可以在 Roblox Studio 控制台输出中确认状态。
2. 在控制台中，确认输出中出现 The MCP Studio plugin is ready for prompts.。点击插件图标可开启或关闭与 Claude Desktop 的 MCP 通信，你也可以在控制台输出中确认状态。
3. 点击输入提示词的文本框下方 MCP 工具的锤子图标，确认 Claude Desktop 配置正确。这会打开一个窗口，其中列出可用的 Roblox Studio 工具（insert_model 和 run_code）。

注意：重启 Studio 和 Claude Desktop 可以解决常见的设置问题。Claude 有时会隐藏在系统托盘中，因此请确保已将其完全退出。

发送请求

1. 在 Studio 中打开一个 place。
2. 在 Claude Desktop 中输入提示词，并接受与 Studio 通信所需的权限。
3. 查看控制台、检查 Explorer 中的数据模型，或通过目视确认 place 中发生了预期更改，以验证 Studio 是否执行了预期操作。