AI导哈

Roblox Studio AI 辅助开发工具

一个MCP服务器工具，允许AI助手如Claude和Gemini连接Roblox Studio，进行游戏结构探索、脚本读写、UI生成及批量修改等操作，支持本地安全开发。

  • by Posuceius
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Posuceius/robloxstudio-mcp-posu

使用说明

Roblox Studio MCP服务器（Posuceius Fork）

将Claude和Gemini等人工智能助手连接到Roblox Studio

这是什么？

一个MCP服务器，让人工智能探索你的游戏结构、读取/编辑脚本、构建UI、提取样式和执行批量更改——所有这些都是本地安全的。

分叉自 boshyxd/robloxstudio mcp 对UI生成、样式提取和AI辅助开发进行了显著增强。

设置

1.安装Studio插件

下载 MCPPlugin.rbxmx 并将其放置在您的Roblox插件文件夹中：

  • 窗户： %LOCALAPPDATA%/Roblox/Plugins/
  • macOS： ~/Documents/Roblox/Plugins/

2.启用HTTP请求

在Roblox Studio中：游戏设置>安全> 允许HTTP请求 =打开

3.连接你的AI

克劳德代码：

claude mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

Codex CLI：

codex mcp add robloxstudio -- npx -y robloxstudio-mcp@latest

Gemini CLI：

gemini mcp add robloxstudio npx --trust -- -y robloxstudio-mcp@latest
Other MCP clients (Claude Desktop, Cursor, etc.) 
{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "npx",
      "args": ["-y", "robloxstudio-mcp@latest"]
    }
  }
}

Windows用户： 如果遇到问题，请使用 cmd:

{
  "mcpServers": {
    "robloxstudio-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "robloxstudio-mcp@latest"]
    }
  }
}

插件准备就绪时显示“已连接”。

你能做什么？

问这样的问题：

  • “这个游戏的结构是什么？”
  • “查找具有已弃用API的脚本并替换它们”
  • “创建带有卡片和按钮的商店UI”
  • “从我现有的UI中提取样式并进行匹配”
  • “将此Luau UI代码导入Studio”
  • “这个游戏有多少部分和脚本？”
  • “输出日志显示什么？”
  • “哪些脚本依赖于此模块？”

此叉子的新功能

UI生成

  • create_ui_tree -使用样式糖快捷键在一次调用中从嵌套的JSON创建整个UI层次结构
  • get_ui_tree -在一次调用中递归序列化完整的UI树（所有属性，默认值被剥离）
  • import_luau_ui -解析Luau代码（Instance.new样式）并在Studio中创建实例
  • set_properties -在一次调用中为单个实例设置多个属性

风格系统

  • extract_ui_style -从现有UI中提取设计标记（颜色、字体、半径、笔划、按频率的间距）
  • 十六进制颜色支持 -使用 "#ff0000" 任何需要Color3的地方
  • 加糖 create_ui_tree -快捷键自动创建修改器实例：
    • cornerRadius: 12 ->UI角落
    • padding: {top: 10, bottom: 10} ->UI填充
    • stroke: {color: "#000", thickness: 2} ->UIStroke
    • gradient: {color: [[0,"#1a1a2e"],[1,"#16213e"]], rotation: 90} ->UI坡度
    • layout: {type: "list", direction: "Vertical", padding: 8} ->UIListLayout
    • aspectRatio: {value: 1.5} ->UIAspectRatio约束
    • sizeConstraint: {minSize: [100,50]} ->UISizeConstraint
    • scale: 1.2 -> UIScale

AI开发工具

  • find_replace_in_scripts -在一次调用中查找和替换所有脚本中的文本（使用模拟运行模式）
  • get_game_stats -实例计数统计（部件、脚本、UI对象、模型、顶级类）
  • get_output_log -无需进行播放测试即可读取Studio输出日志
  • get_script_dependencies -跟踪require（）链（脚本依赖于什么以及依赖于什么）

改进响应

  • 默认属性剥离 - get_instance_properties 和 stripDefaults: true 消除噪音
  • 有组织的属性序列化 -返回特定于类的属性（GUI、文本、图像、滚动、修饰符）
  • 结构化值 -Color3、UDim2、Vector2、Vector3作为对象而不是原始字符串返回
  • LLM友好的脚本输出 - get_script_source 返回带类型、位置和行信息的格式化标头

MCP提示

  • roblox_ui_guide -全面的Roblox UI开发指南（属性、布局、修改器、模式）
  • roblox_style_extraction -从现有游戏中提取和匹配样式的指南

所有工具

阅读工具（35）

get_file_tree, search_files, get_place_info, get_services, search_objects, get_instance_properties, get_instance_children, search_by_property, get_class_info, get_project_structure, mass_get_property, get_script_source, grep_scripts, get_attribute, get_attributes, get_tags, get_tagged, get_selection, get_playtest_output, search_assets, get_asset_details, get_asset_thumbnail, get_ui_tree, extract_ui_style, get_game_stats, get_output_log, get_script_dependencies, get_build, list_library, search_materials, preview_asset, export_build, capture_screenshot, start_playtest, stop_playtest

书写工具（29）

set_property, set_properties, mass_set_property, set_calculated_property, set_relative_property, create_object, mass_create_objects, create_ui_tree, import_luau_ui, delete_object, smart_duplicate, mass_duplicate, set_script_source, edit_script_lines, insert_script_lines, delete_script_lines, find_replace_in_scripts, set_attribute, delete_attribute, add_tag, remove_tag, execute_luau, insert_asset, undo, redo, create_build, generate_build, import_build, import_scene

**v3.1.0** - 64 tools, UI generation, style extraction, AI dev tools, MCP prompts

报告问题 |MIT许可证

相关 MCP