Roblox Studio MCP服务器

Roblox Studio MCP服务器是一个基于Rust的参考实现,用于在Roblox Studio和AI工具(如Claude Desktop或Cursor)之间建立通信,支持多种工具操作。

  • by Roblox
  • Rust
  • 本地部署
  • 498 星标
  • 更新于
在 GitHub 查看 roblox/studio-rust-mcp-server

使用说明

[!警告]

此MCP服务器不再处于积极开发状态

我们已经将正在进行的工程投资转移到 Roblox Studio附带的内置MCP服务器,我们建议这是未来连接外部AI工具的最佳方式。

此服务器的源代码和以前的版本将保留在此处供参考和现有工作流使用。

快速设置

  1. 下载并运行服务器: 视窗 或 macOS
  2. 重新启动AI客户端(Claude、Cursor等)和Roblox Studio
  3. 完成!

Roblox Studio MCP服务器

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

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

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

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

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

包含的工具

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

设置

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

此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目录。

对于Claude Desktop,请转到“设置”>“开发人员”>“编辑配置”。这将打开以下位置 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工作室 和 克劳德桌面 安装并启动至少一次。
  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中的数据模型,或直观地确认您的位置发生了所需的更改。