Roblox Studio MCP Server

Roblox Studio MCP Server

MCP server for AI-powered Roblox Studio integration. 18 specialized tools for exploring projects, analyzing scripts, and performing bulk operations.

Quick Start

For Claude Code users:

For other MCP clients (Claude Desktop, etc.):

Studio Plugin Setup (Required)

The MCP server requires a companion Roblox Studio plugin:

1. Roblox Creator Store:
   • Install from: https://create.roblox.com/store/asset/75577477776988
   • Click "Install" - Opens in Studio automatically
2. Manual download:
   • Download MCPPlugin.rbxmx
   • Save to your %LOCALAPPDATA%/Roblox/Plugins folder
3. Advanced setup:
   • See studio-plugin/INSTALLATION.md for other methods

After installation:

• Enable "Allow HTTP Requests" in Game Settings > Security
• Click the "MCP Server" button in the Plugins toolbar
• Status should show "Connected" when working

Architecture Overview

Dual-component system bridging Roblox Studio with AI assistants:

Key Components:

• MCP Server (Node.js/TypeScript) - Exposes 18 tools via stdio
• HTTP Bridge - Request/response queue on localhost:3002
• Studio Plugin (Luau) - Polls server and executes API calls
• Smart Caching - Efficient data transfer

18 AI Tools

File System Tools

• get_file_tree - Complete project hierarchy with scripts, models, folders
• search_files - Find files by name, type, or content patterns

Studio Context Tools

• get_place_info - Place ID, name, game settings, workspace info
• get_services - All Roblox services and their child counts
• search_objects - Find instances by name, class, or properties

Instance & Property Tools

• get_instance_properties - Complete property dump for any object
• get_instance_children - Child objects with metadata
• search_by_property - Find objects with specific property values
• get_class_info - Available properties/methods for Roblox classes

Property Modification Tools

• set_property - Set a property on any Roblox instance
• mass_set_property - Set the same property on multiple instances
• mass_get_property - Get the same property from multiple instances

Object Creation Tools

• create_object - Create a new Roblox object instance
• create_object_with_properties - Create objects with initial properties
• mass_create_objects - Create multiple objects at once
• mass_create_objects_with_properties - Create multiple objects with properties
• delete_object - Delete a Roblox object instance

Project Analysis Tools

• get_project_structure - Smart hierarchy with depth control (recommended: 5-10)

Note: Previous tools removed: get_file_content, get_file_properties, get_selection, get_dependencies, validate_references. Use Rojo/Argon workflows instead.

AI-Optimized Features

Mass Operations (v1.3.0)

• Bulk property editing
• Mass object creation
• Batch property reading
• Atomic undo/redo operations

Smart Project Structure

• Service overview with child counts
• Path-based exploration: get_project_structure("game.ServerStorage", maxDepth=5)
• Script-only filtering for code analysis
• Intelligent grouping for large folders
• Recommended maxDepth=5-10

Rich Metadata

• Script status tracking
• GUI intelligence
• Performance optimized

Development & Testing

Commands

Plugin Development

• Live reload
• Robust error handling
• Debug logging
• Visual status indicators

Communication Protocol

Features:

• 30-second timeouts with exponential backoff
• Automatic retries
• Response limiting
• Request deduplication

Example Usage

Configuration

Environment Variables:

• MCP_SERVER_PORT - MCP server port (default: stdio)
• HTTP_SERVER_PORT - HTTP bridge port (default: 3002)
• PLUGIN_POLL_INTERVAL - Plugin poll frequency (default: 500ms)
• REQUEST_TIMEOUT - Request timeout (default: 30000ms)

Studio Settings:

• Allow HTTP Requests (Game Settings > Security)
• HttpService.HttpEnabled = true
• Plugin activated via toolbar button

License

MIT License - Feel free to use in commercial and personal projects!