项目简介

'studio-rust-mcp-server' 是 Model Context Protocol (MCP) 的一个参考实现，旨在通过 MCP 协议连接 Roblox Studio 与 LLM 客户端（如 Claude Desktop）。它允许 LLM 直接与 Roblox Studio 环境进行交互，执行特定操作并获取上下文信息。

该服务器通过内部组件协同工作：一个负责与 Roblox Studio 插件通信的 Web 服务器，以及一个实现 MCP 协议并通过标准 I/O ('stdio') 与 LLM 客户端通信的核心服务器。

主要功能点

• 实现 MCP 协议通信： 遵循 MCP 规范，通过 JSON-RPC 在标准 I/O 上与 LLM 客户端（如 Claude Desktop）交换信息。
• 注册和执行 Roblox Studio 工具： 向 LLM 客户端暴露特定的 Roblox Studio 功能作为工具。目前支持的工具包括：
  • 'run_code': 在 Roblox Studio 环境中执行 Lua 代码，并返回输出。可用于查询或修改场景。
  • 'insert_model': 从 Roblox 资源市场搜索并插入模型到 Studio 工作区。
• 管理与 Roblox Studio 插件的交互： 通过内置的 HTTP 服务器与安装在 Roblox Studio 中的配套插件进行通信，协调 LLM 的指令在 Studio 中的实际执行。
• 声明服务器能力： 向客户端报告支持的协议版本和功能（如支持工具调用）。

安装步骤

推荐使用预编译的发布二进制文件进行安装：

1. 确保已安装并至少启动过一次 Roblox Studio 和 Claude Desktop。
2. 完全退出 Roblox Studio 和 Claude Desktop。
3. 访问项目的 GitHub Release 页面，下载适用于您操作系统的最新版本安装包。
4. 解压下载的文件（如果需要），然后运行安装程序。
5. 重新启动 Claude Desktop 和 Roblox Studio。

从源代码构建安装：

1. 确保已安装并至少启动过一次 Roblox Studio 和 Claude Desktop。
2. 完全退出 Roblox Studio 和 Claude Desktop。
3. 安装 Rust。
4. 下载或克隆此仓库。
5. 在仓库根目录运行 'cargo run' 命令。这将构建服务器程序，安装 Roblox Studio 插件，并配置 Claude Desktop。

安装完成后，Roblox Studio MCP 服务器已准备就绪。

服务器配置

MCP 客户端（如 Claude Desktop）需要知道如何启动并连接到此 MCP 服务器。安装程序会自动配置 Claude Desktop，使其在需要时通过标准 I/O ('stdio') 启动服务器。

对于 MCP 客户端来说，需要配置的信息主要包括：

• 服务器名称： 用于客户端界面中标识此服务器（例如 "Roblox Studio"）。
• 启动命令 (command)： 服务器可执行文件的完整路径。
• 启动参数 (args)： 启动服务器所需的命令行参数。对于此实现，需要包含 '--stdio' 参数，表示通过标准 I/O 进行通信。

安装程序会将这些信息写入 Claude Desktop 的配置文件中（如 macOS 上的 '~/Library/Application Support/Claude/claude_desktop_config.json' 或 Windows 上的 '%APPDATA%\Claude\claude_desktop_config.json'），使得 Claude Desktop 能够正确地找到并启动服务器。

基本使用方法

1. 打开 Roblox Studio 并加载一个项目（place）。
2. 在 Claude Desktop 中，确保已连接到 "Roblox Studio" MCP 服务器（通常安装后会自动连接）。您可以在 Claude 的 MCP 工具列表中看到 'run_code' 和 'insert_model' 工具。
3. 在 Claude Desktop 的聊天输入框中输入您的请求，例如“在场景中插入一个树模型”或“运行一段代码获取当前场景中的零件数量”。
4. 根据提示接受与 Roblox Studio 通信的权限请求。
5. 在 Roblox Studio 中观察结果，可以通过控制台输出、资源管理器或场景视图来验证 LLM 执行的操作是否成功。