Roblex Studio Model-Context-Protocol Server

Roblex Studio Model-Context-Protocol 服务端

Roblex Studio MCP 服务是 Model-Context-Protocol 规范的独立服务端实现，专为与 Roblox Studio 和大模型集成而设计。它通过统一协议，在 Roblox Studio 中实现无缝、安全且可脚本化的 AI 驱动工作流。

功能

• npx 一键安装/运行：使用 npx roblex-mcp 即可立即启动
• 自动启动 Roblox Studio：MCP 启动后会自动启动 Roblox Studio（Windows）
• 完整实现 MCP：支持所有核心 Model-Context-Protocol 功能
• 多种传输模式：支持 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. 点击 Create API Key，选择所需权限（例如，“Write Assets”“Read Universe Data”），然后复制生成的 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，用于限定到特定 universe 的操作。

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 密钥错误或出现“Unauthorized”？

  • 确认 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 贡献者