使用说明
Roblox MCP v2.0
MCP服务器为AI驱动的Roblox Studio开发提供12个工具。
适用于任何兼容MCP的AI客户端（Cursor、Windsurf、Claude Code、Antigravity等）
快速开始
npm install
添加到MCP配置中：
{
"roblox-mcp": {
"command": "node",
"args": ["/path/to/roblox-mcp/index.js"]
}
}
复制 RobloxMCPPlugin.server.luau 到您的Roblox Studio插件文件夹：
%LOCALAPPDATA%/Roblox/Plugins/
启用 Http服务 在Studio中：游戏设置→ 安全→ 允许HTTP请求。
工具
| 工具 | 说明 |
|---|---|
run_code |
在Studio中执行任意Luau |
take_screenshot |
Capture Studio视口（打印窗口——无焦点窃取） |
get_descendants |
遍历实例树（深度受限） |
get_properties |
读取实例属性 |
find_instances |
按类名/名称模式搜索 |
set_property |
通过Luau表达式设置属性 |
create_instance |
创建+父级+设置属性 |
delete_instance |
带有所需确认标志的销毁 |
get_selection |
获取当前选定的实例 |
move_camera |
放置摄像头进行截图 |
get_output_log |
读取LogService历史记录 |
get_health |
桥接诊断（即时，无Luau） |
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
ROBLOX_MCP_PORT |
18820 |
用于插件通信的HTTP网桥端口 |
ROBLOX_MCP_SCREENSHOTS_DIR |
./screenshots （CWD） |
截图输出目录 |
建筑
AI Agent ←stdio→ index.js (MCP + HTTP Bridge) ←HTTP→ RobloxMCPPlugin.server.luau
- 自恢复桥：15s超时自动清除状态，永不永久卡住
- 结构化协议:
{success, result, error}具有自动序列化的Roblox类型 - 打印窗口截图：捕获而不窃取焦点（仅限Windows）
- 注射安全：值表达式使用级别递增的长字符串
[=[...]=]
需求
- Node.js≥18
- Roblox工作室（Windows）
- PowerShell（用于
take_screenshot)
许可证
麻省理工学院
