Roblox Opencloud MCP Server

Roblox开放云MCP服务器

一个生产形状MCP（模型上下文协议）服务器，它封装了 公共Roblox Open Cloud表面作为AI代理的键入工具。用它 管理体验、无头运行Luau、读写数据存储 和内存商店，运送货币化产品，处理审核， 从Claude Code内部发送体验通知等， Claude Desktop、Cursor或任何兼容MCP的客户端。

v0.1.1 — 96工具 穿过 18个域名. 搭配战略 限制.md 那张地图 Open Cloud表面的程序差距。服务器是 对于告诉你你的事情很有用 _不能_ 从Roblox外面做 尽你所能。

______________________________________________________________________

快速入门（5分钟）

# 1. Clone and build
git clone https://github.com/kevinswint/roblox-opencloud-mcp-server.git
cd roblox-opencloud-mcp-server
npm install
npm run build

# 2. Create an API key at
#    https://create.roblox.com/dashboard/credentials
#    with the scopes you need (see "Scopes" below)

# 3. Register with Claude Code (stdio transport)
claude mcp add roblox-opencloud-mcp \
  -e ROBLOX_API_KEY=your_key_here \
  -- node "$(pwd)/dist/index.js"

# 4. Verify — lists every registered tool
npm run list-tools

现在，您应该可以向Claude Code询问以下问题：

“从中提取用户12345的最后5个数据存储条目 UserProgress 存储在宇宙123456中。”

无需手动点击Creator Hub即可实现。

看 演示.md 对于11个端到端代理流，您可以复制粘贴。

______________________________________________________________________

运输方式

标准 （默认，建议用于本地桌面客户端）：

ROBLOX_API_KEY=your_key node dist/index.js

超文本传输协议 （用于远程多客户端访问）：

TRANSPORT=http ROBLOX_API_KEY=your_key PORT=3000 node dist/index.js
# Server listens on http://localhost:3000/mcp
# Health check: http://localhost:3000/health

两种模式均由官方提供动力 @modelcontextprotocol/sdk — 没有定制运输。通过翻转来交换它们 TRANSPORT.

______________________________________________________________________

配置

______________________________________________________________________

工具索引（96个工具）

跑 npm run list-tools 从源重新生成此列表 真相。下面是手动分组视图。

卢执行（2）

数据存储（7）

有序数据存储（6）

存储器（10）

消息传递（1）

体验与场所管理（5）

货币化——开发者产品和游戏通行证（8）

创造者商店产品（2）

配置（佐治亚州2026年3月10日）（8）

宇宙秘密（5）

适度——用户限制（4）

资产（10）

团体（9）

用户和库存（4）

徽章（6）

缩略图（5）

通知（1）

生成型人工智能（3）

______________________________________________________________________

范围

使用实际需要的作用域配置API密钥。服务器 报告一个结构化错误，该错误指向 403 所以你可以毫无猜测地做出反应。

______________________________________________________________________

建筑

src/
├── index.ts                  — Server init, transport setup, tool registration
├── constants.ts              — API base URLs, limits, timeouts
├── types.ts                  — Shared response-shape interfaces
├── schemas/
│   └── common.ts             — Shared Zod schemas (universe_id, pagination, etc.)
├── services/
│   ├── api-client.ts         — HTTP client, auth, rate-limited requests, error mapping
│   ├── rate-limiter.ts       — Token-bucket, 500 req/min shared ceiling per API key
│   └── logger.ts             — Structured JSON-per-line stderr logging
├── scripts/
│   └── list-tools.ts         — Discovery harness (`npm run list-tools`)
└── tools/
    ├── luau-execution.ts
    ├── data-stores.ts
    ├── ordered-data-stores.ts
    ├── memory-stores.ts
    ├── messaging.ts
    ├── universes.ts
    ├── monetization.ts
    ├── creator-store.ts
    ├── config.ts
    ├── secrets.ts
    ├── user-restrictions.ts
    ├── assets.ts
    ├── groups.ts
    ├── users.ts
    ├── badges.ts
    ├── thumbnails.ts
    ├── notifications.ts
    └── generative-ai.ts

每个工具处理程序都要经过：

1. wrapTool （logger.ts）--记录 (tool_name, input_hash, latency_ms, result_status) 将JSON转换为stderr。Stdout是为MCP协议本身保留的。
2. rateLimiter.acquire() （rate-limiter.ts）-每个API键在500 req/min共享的开放云上限下的paces调用。当存储桶已满80%以上时，向stderr发出警告。
3. makeApiRequest （api-client.ts）--添加 x-api-key，应用超时，将结构化API错误解析为可人工读取的消息，这些消息命名了403上缺失的作用域。
4. truncateResponse --将标记文本响应限制在25000个字符以内，这样MCP客户端就不会被巨大的DataStore blob阻塞。使用 response_format="json" 在需要原始数据时绕过。

______________________________________________________________________

故障排除

Error: ROBLOX_API_KEY environment variable is required 在启动服务器之前设置env var。使用Claude Code，使用 claude mcp add ... -- env ROBLOX_API_KEY=....

403 Forbidden: missing scope "..." API键没有工具所需的作用域。打开 create.roblox.com/dashboard/credentials, 编辑密钥，添加作用域，保存，然后重试。

429 Too Many Requests 尽管进行了内部起搏，但仍超过了心率限制上限。这通常 意味着另一个进程正在使用相同的API密钥。检查你的 服务器日志记录速率限制警告行，并记录速度减慢或 提供第二把钥匙。

大型响应被截断 服务器将降价响应限制在25000个字符以内以保护 MCP客户端。通过 response_format="json" 绕过盖子。

Luau执行任务卡住 PROCESSING Luau Execution API仍然是测试版。检查创建者中心→ 账户 设置→ Beta功能→ “开放云Luau执行”已启用 所属用户/组。看 限制.md.

______________________________________________________________________

什么没包

看 限制.md 查看Open Cloud的完整地图 该服务器故意不包装（仅cookie API， 测试版不稳定，Creator Hub的长尾功能没有 公共程序界面）。该文件是 这个项目——它将MCP服务器变成了一个可以采取行动的差距分析 上。

______________________________________________________________________

许可证

麻省理工学院——见 许可证.