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@latestCodex CLI:
codex mcp add robloxstudio -- npx -y robloxstudio-mcp@latestGemini CLI:
gemini mcp add robloxstudio npx --trust -- -y robloxstudio-mcp@latestOther 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许可证
