Roblox Studio MCP 服务器

Roblox Studio MCP 服务器是一个基于 Rust 的参考实现,用于在 Roblox Studio 插件与 Claude Desktop 或 Cursor 之间通过 Model Context Protocol (MCP) 进行通信,支持工具运行请求和响应传输。

  • by Z4H1DD
  • Rust
  • 本地部署
  • 更新于
在 GitHub 查看 Z4H1DD/RobloxMCP

使用说明

Roblox Studio MCP服务器

此存储库包含模型上下文协议(MCP)的参考实现,该实现启用 Roblox Studio通过插件与 克劳德桌面 或 光标. 它由以下基于Rust的组件组成,这些组件通过内部共享进行通信 物体。

  • 基于以下内容构建的web服务器 axum Studio插件长期轮询。
  • A. rmcp 通过以下方式与Claude对话的服务器 stdio 运输。

当LLM请求运行工具时,插件将通过长轮询收到请求,并发布 回应。它将导致响应被发送到Claude应用程序。

请注意 此MCP服务器将由第三方工具访问,允许他们修改 并阅读你打开的地方的内容。第三方数据处理和隐私实践 根据各自的条款和条件。

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

设置

使用发布的二进制文件进行安装

此MCP服务器几乎支持任何MCP客户端,但只会自动设置 克劳德桌面 和 光标 如果找到。

要自动设置,请执行以下操作:

  1. 确保你有 Roblox工作室, 和 克劳德桌面/光标 安装并启动至少一次。
  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/RobloxStudioMCP.app/Contents/MacOS/rbx-studio-mcp" 如果将应用程序移动到Applications目录。

从源代码构建

要从此存储库的源代码构建和安装MCP参考实现,请执行以下操作:

  1. 确保你有 Roblox工作室 和 克劳德桌面 安装并启动至少一次。
  2. 如果Claude和Roblox Studio正在运行,请退出。
  3. 安装 生锈。
  4. 下载或克隆此存储库。
  5. 从该存储库的根目录运行以下命令。
    cargo run
    
    此命令执行以下操作:
    • 构建Rust MCP服务器应用程序。
    • 设置Claude与MCP服务器通信。
    • 构建并安装Studio插件以与MCP服务器通信。

命令完成后,Studio MCP服务器已安装并准备好接受来自的提示 克劳德桌面。

验证设置

要确保所有设置都正确,请执行以下步骤:

  1. 在Roblox Studio中,点击 插件 选项卡并验证MCP插件是否出现。点击 该图标可打开和关闭MCP与Claude Desktop的通信,您可以在中进行验证 Roblox Studio控制台输出。
  2. 在控制台中,验证 The MCP Studio plugin is ready for prompts. 出现在输出中。 点击插件图标可打开和关闭MCP与Claude Desktop的通信, 您也可以在控制台输出中验证。
  3. 点击MCP工具的锤子图标,验证Claude Desktop是否正确配置 在输入提示的文本字段下方。这应该会打开一个包含以下列表的窗口 可用的Roblox Studio工具(insert_model 和 run_code).

备注:您可以通过重新启动Studio和Claude Desktop来修复安装程序的常见问题。克劳德 有时隐藏在系统托盘中,因此请确保您已完全退出它。

发送请求

  1. 在Studio中打开一个位置。
  2. 在Claude Desktop中键入提示,并接受与Studio通信的任何权限。
  3. 通过检查控制台、检查 Explorer中的数据模型,或直观地确认您的位置发生了所需的更改。