Roblox Studio MCP Server

基本能力

产品定位

Roblox Studio MCP Server 是一个专为 Roblox Studio 开发设计的 MCP 服务器，旨在通过标准化接口提供对 Roblox Studio 文档、模板、代码生成功能等的访问。

核心功能

• 资源访问：提供对 Roblox Studio 文档、API 参考和代码模板的访问。
• 工具支持：包括 Luau 代码生成与验证、资产搜索、游戏组件生成等工具。
• 提示功能：提供脚本生成、错误查找和性能优化的特殊提示。
• API 集成：直接连接 Roblox API 和 Open Cloud API。
• 交互式系统：支持创建对话系统、UI 界面和复杂游戏机制。
• 性能优化：内置缓存和速率限制以优化性能。
• 错误处理：全面的错误管理和恢复机制。
• 监控与指标：内置健康检查和性能指标。

适用场景

• Roblox 游戏开发中的脚本生成与优化。
• 游戏资产的管理与搜索。
• 游戏性能的监控与优化。
• 开发者工具集成与自动化。

工具列表

1. 代码生成器：根据用户需求生成 Roblox Luau 代码。
2. 资产搜索器：根据条件搜索 Roblox 资产。
3. 脚本验证器：验证 Luau 脚本的语法和最佳实践。
4. 数据存储管理器：生成完整的 DataStore 代码。
5. 物理系统生成器：生成 Roblox 物理系统代码。
6. UI 构建器：生成 Roblox UI 代码。
7. Roblox API 连接器：直接连接 Roblox API 和 Open Cloud API。

常见问题解答

1. 连接错误：检查 Roblox API 密钥是否正确配置。
2. 高内存使用：调整缓存 TTL 设置以管理内存使用。
3. 速率限制错误：调整 RATE_LIMIT_* 设置以适应环境需求。

使用教程

使用依赖

• Node.js >= 18.x
• npm 或 yarn
• Roblox API 密钥（用于 API 集成功能）
• Roblox Open Cloud API 密钥（用于 Open Cloud 功能）

安装教程

1. 克隆仓库

git clone https://github.com/dmae97/roblox-studio-mcp-server.git
cd roblox-studio-mcp-server

1. 安装依赖

npm install

1. 创建 .env 文件

cp .env.example .env

1. 更新 .env 文件

ROBLOX_API_KEY=your_api_key_here
ROBLOX_OPEN_CLOUD_API_KEY=your_open_cloud_api_key_here
ROBLOX_OPEN_CLOUD_UNIVERSE_ID=your_universe_id_here

1. 构建项目

npm run build

调试方式

1. 开发模式启动

npm run dev

1. 生产模式启动

npm start

1. 检查日志

LOG_LEVEL=debug npm start

许可证

该项目遵循 MIT 开源许可条款。