Roblex Studio 模型-上下文-协议服务器

Roblex Studio MCP 服务器是 模型-上下文-协议 规范的一个独立服务器实现，专门设计用于与 Roblox Studio 和大型语言模型（LLMs）集成。它通过统一的协议在 Roblox Studio 中实现了无缝、安全且可脚本化的AI驱动工作流。

特性

• npx 一键安装/运行：使用 npx roblex-mcp 即刻启动
• 自动启动 Roblox Studio：MCP 启动并自动启动 Roblox Studio（仅限 Windows）
• 完整的 MCP 实现：支持所有核心的模型-上下文-协议功能
• 多种传输模式：SSE 或 STDIO，以实现灵活集成
• Claude Desktop/Anthropic Claude 支持：开箱即用的集成
• 安全性：TPA 保护、输入净化、速率限制、CORS 等
• 可扩展性：轻松添加自定义工具/资源

快速开始

先决条件

• Node.js 18 或更高版本（推荐使用 Node.js 20+）
• 已安装 Roblox Studio（仅限 Windows；见下文启动路径）
• npm（随 Node.js 一起捆绑）

使用 npx 运行

npx roblex-mcp

• 首次启动时，MCP 将启动并尝试自动打开 Roblox Studio。
• 如果您的 Roblox Studio 不在标准位置，请在 .env 文件或系统环境中设置 ROBLOX_STUDIO_PATH 环境变量。

环境配置

复制并编辑示例环境文件：

cp .env.example .env

根据需要编辑 .env 文件（见下文关于 ROBLOX_STUDIO_PATH 的说明）。

Roblox/Open Cloud API 密钥设置

为了启用自动化脚本和资产管理工作，您必须提供有效的 Roblox Open Cloud API 密钥。

1. 转到 Roblox Open Cloud 控制台。
2. 点击 创建 API 密钥，选择所需的权限（例如，“写入资产”，“读取宇宙数据”），并复制生成的 API 密钥。
3. 将此密钥放入您的 .env 文件中：

   ROBLOX_API_KEY=your_api_key_here
   ROBLOX_OPEN_CLOUD_API_KEY=your_open_cloud_api_key_here
   

   • 切勿分享您的密钥。像对待密码一样对待它们。
   • 可选地，设置 ROBLOX_OPEN_CLOUD_UNIVERSE_ID 以进行宇宙范围的操作。
4. 编辑 .env 文件后重启 MCP 以应用更改。

更多详情请参阅 Roblox Open Cloud 文档。

环境变量

所有配置都可以通过 .env 文件控制。关键变量包括：

• PORT：服务器端口（默认：3001）

• TRANSPORT_MODE：'sse' 或 'stdio'（默认：'stdio'）

• CLAUDE_DESKTOP_ENABLED：Claude Desktop 集成（默认：true）

• ROBLOX_STUDIO_PATH：RobloxStudioBeta.exe 的完整路径（可选）。例如：

  ROBLOX_STUDIO_PATH=C:\Users\USER\AppData\Local\Roblox\Versions\version-04a222f011414c81\RobloxStudioBeta.exe
  

• ROBLOX_API_KEY, ROBLOX_OPEN_CLOUD_API_KEY：来自 Roblox Open Cloud 的 API 密钥；大多数服务器功能都需要这些密钥。

有关所有选项，请参阅 .env.example。

工作原理

• npx roblex-mcp：

  • 启动 MCP 服务器（传输、工具、API、安全等）
  • 自动启动 Roblox Studio
  • 可以与 Claude Desktop、Open Cloud 等集成

• 自定义工具和资源：

  • 通过扩展 src/tools 和 src/resources 目录来添加自己的工具和资源。

故障排除

• Roblox Studio 无法打开？

  • 在 .env 中设置 ROBLOX_STUDIO_PATH 为 RobloxStudioBeta.exe 的完整路径。

• API 密钥错误或“未授权”？

  • 确保您的 API 密钥有效，具有正确的权限，并已设置在 .env 中。

• 权限错误或端口冲突？

  • 确保您有权绑定服务器端口，或者在 .env 中选择非标准端口。

• TypeScript/模块错误？

  • 如果本地开发，请运行 npm install 和 npm run build，但 npx 用户不需要这一步。

• Claude Desktop 未检测到？

  • 确保 .env 中 CLAUDE_DESKTOP_ENABLED=true 并且 Claude Desktop 正在运行。

开发

克隆、安装并构建：

git clone https://github.com/dmae97/roblex-studio-mcp-server.git
cd roblex-studio-mcp-server
npm install
npm run build
npm start

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 获取指南。

许可证

MIT 许可证 - 详见 LICENSE

---

© 2025 Roblex Studio MCP Server 贡献者