Roblox Studio MCP 服务器

此仓库包含一个参考实现，该实现通过插件在 Roblox Studio 和 Claude Desktop 或 Cursor 之间启用通信。它由以下基于 Rust 的组件组成，这些组件通过内部共享对象进行通信。

• 使用 axum 构建的 Web 服务器，供 Studio 插件进行长轮询。
• 使用 stdio 传输与 Claude 通信的 rmcp 服务器。

当大型语言模型（LLM）请求运行工具时，插件会通过长轮询获取请求并发送响应。这将导致响应被发送到 Claude 应用程序。

请注意，此 MCP 服务器将被第三方工具访问，允许它们修改和读取您打开的地方的内容。第三方数据处理和隐私实践受其各自条款和条件的约束。

设置过程还包括一个简短的插件安装和 Claude Desktop 配置脚本。

设置

使用发布二进制文件安装

此 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"。

从源码构建

要从这个仓库的源码构建和安装 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 中，点击 插件 标签，并验证 MCP 插件是否出现。点击图标可切换与 Claude Desktop 的 MCP 通信，您可以在 Roblox Studio 控制台输出中验证这一点。
2. 在控制台中，验证输出中是否显示了 The MCP Studio plugin is ready for prompts.。点击插件图标可以切换与 Claude Desktop 的 MCP 通信，您也可以在控制台输出中验证这一点。
3. 通过点击文本字段下方的锤子图标来验证 Claude Desktop 是否正确配置了 MCP 工具。这应该会打开一个窗口，列出可用的 Roblox Studio 工具（insert_model 和 run_code）。

注意：您可以通过重新启动 Studio 和 Claude Desktop 来解决常见的设置问题。有时 Claude 可能隐藏在系统托盘中，因此请确保完全退出它。

发送请求

1. 在 Studio 中打开一个地方。
2. 在 Claude Desktop 中键入提示并接受任何与 Studio 通信的权限。
3. 通过检查控制台、查看 Explorer 中的数据模型或视觉确认您的地方中的所需更改，验证 Studio 中是否执行了预期的操作。 </中文翻译>