Roblox Studio MCP Server (Posuceius Fork)

Connect AI assistants like Claude and Gemini to Roblox Studio

What is This?

An MCP server that lets AI explore your game structure, read/edit scripts, build UIs, extract styles, and perform bulk changes - all locally and safely.

Forked from boshyxd/robloxstudio-mcp with significant enhancements for UI generation, style extraction, and AI-assisted development.

Related MCP server: robloxstudio-mcp

Setup

1. Install the Studio Plugin

Download MCPPlugin.rbxmx and place it in your Roblox Plugins folder:

• Windows: %LOCALAPPDATA%/Roblox/Plugins/

• macOS: ~/Documents/Roblox/Plugins/

2. Enable HTTP Requests

In Roblox Studio: Game Settings > Security > Allow HTTP Requests = ON

3. Connect Your AI

Claude Code:

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

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

Windows users: If you encounter issues, use cmd:

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

Plugin shows "Connected" when ready.

What Can You Do?

Ask things like:

• "What's the structure of this game?"

• "Find scripts with deprecated APIs and replace them"

• "Create a shop UI with cards and buttons"

• "Extract the style from my existing UI and match it"

• "Import this Luau UI code into Studio"

• "How many parts and scripts are in this game?"

• "What does the output log say?"

• "What scripts depend on this module?"

New Features in This Fork

UI Generation

• create_ui_tree - Create entire UI hierarchies from nested JSON in one call with style sugar shortcuts

• get_ui_tree - Recursively serialize a full UI tree in one call (all properties, defaults stripped)

• import_luau_ui - Parse Luau code (Instance.new style) and create instances in Studio

• set_properties - Set multiple properties on a single instance in one call

Style System

• extract_ui_style - Extract design tokens from existing UI (colors, fonts, radii, strokes, spacing by frequency)

• Hex color support - Use "#ff0000" anywhere a Color3 is expected

• Style sugar on create_ui_tree - Shorthand keys auto-create modifier instances:

  • cornerRadius: 12 -> UICorner

  • padding: {top: 10, bottom: 10} -> UIPadding

  • stroke: {color: "#000", thickness: 2} -> UIStroke

  • gradient: {color: [[0,"#1a1a2e"],[1,"#16213e"]], rotation: 90} -> UIGradient

  • layout: {type: "list", direction: "Vertical", padding: 8} -> UIListLayout

  • aspectRatio: {value: 1.5} -> UIAspectRatioConstraint

  • sizeConstraint: {minSize: [100,50]} -> UISizeConstraint

  • scale: 1.2 -> UIScale

AI Development Tools

• find_replace_in_scripts - Find and replace text across all scripts in one call (with dry run mode)

• get_game_stats - Instance count statistics (parts, scripts, UI objects, models, top classes)

• get_output_log - Read Studio Output log without requiring a playtest

• get_script_dependencies - Trace require() chains (what a script depends on and what depends on it)

Improved Responses

• Default property stripping - get_instance_properties with stripDefaults: true removes noise

• Organized property serialization - Returns class-specific properties (GUI, text, image, scroll, modifiers)

• Structured values - Color3, UDim2, Vector2, Vector3 returned as objects instead of raw strings

• LLM-friendly script output - get_script_source returns formatted headers with type, location, and line info

MCP Prompts

• roblox_ui_guide - Comprehensive Roblox UI development guide (properties, layout, modifiers, patterns)

• roblox_style_extraction - Guide for extracting and matching styles from existing games

All Tools

Read Tools (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

Write Tools (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

Report Issues | MIT Licensed