Skip to main content
Glama

Roblox Studio MCP Server

by boshyxd

Roblox Studio MCP Server

A powerful MCP (Model Context Protocol) server that gives AI assistants comprehensive access to Roblox Studio projects. Explore game architecture, analyze scripts, debug issues, and understand complex Roblox projects through 15 specialized AI tools.

⚡ Quick Start (One Command)

For Claude Code users:

claude mcp add robloxstudio -- npx -y robloxstudio-mcp

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

{ "mcpServers": { "robloxstudio-mcp": { "command": "npx", "args": ["-y", "robloxstudio-mcp"], "description": "Advanced Roblox Studio integration for AI assistants" } } }

🔌 Studio Plugin Setup (Required)

The MCP server requires a companion Roblox Studio plugin:

  1. Roblox Creator Store (Easiest ⭐):
  2. Manual download:
  3. Advanced setup:

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

This is a dual-component system bridging Roblox Studio with AI assistants:

Key Components:

  • 🧠 MCP Server (Node.js/TypeScript) - Exposes 15 tools via stdio for AI integration
  • 🔗 HTTP Bridge - Request/response queue on localhost:3002 with 30s timeouts
  • 🎮 Studio Plugin (Luau) - Polls every 500ms, executes Studio API calls, handles errors
  • 📊 Smart Caching - Efficient data transfer with intelligent response limiting

🛠️ 15 Powerful AI Tools

📁 File System Tools

  • get_file_tree - Complete project hierarchy with scripts, models, folders
  • get_file_content - Extract source code from any script
  • search_files - Find files by name, type, or content patterns
  • get_file_properties - Script metadata, parent/child relationships

🎯 Studio Context Tools

  • get_place_info - Place ID, name, game settings, workspace info
  • get_services - All Roblox services and their child counts
  • get_selection - Currently selected objects in Studio Explorer
  • 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 (scripts, GUI types, etc.)
  • search_by_property - Find objects with specific property values
  • get_class_info - Available properties/methods for Roblox classes

🏢 Project Analysis Tools

  • get_project_structure - 🆕 AI-Optimized! Smart hierarchy with depth control
  • get_dependencies - Module dependency mapping and require() analysis
  • validate_references - Find broken script references and missing modules

🧠 AI-Optimized Features

Smart Project Structure

  • Service Overview Mode: Clean service list with child counts
  • Path-based Exploration: get_project_structure("game.ServerStorage", maxDepth=3)
  • Script-only Filtering: scriptsOnly=true for code analysis
  • Intelligent Grouping: Large folders auto-group by class type
  • Progressive Discovery: Depth limits prevent context bloat

Rich Metadata

  • Script Status: Enabled/disabled, source detection, script types
  • GUI Intelligence: Text content, visibility, container vs interactive
  • Dependency Mapping: Complete require() call analysis
  • Reference Validation: 27+ issue types detected automatically

🚀 Development & Testing

Commands

npm run dev # Development server with hot reload npm run build # Production build npm start # Run built server npm run lint # ESLint code quality npm run typecheck # TypeScript validation

Plugin Development

  • Live reload: Plugin updates automatically detect server changes
  • Error handling: Robust timeout and retry mechanisms
  • Debug mode: Detailed logging in Studio Output window
  • Connection status: Visual indicators in plugin UI

📊 Communication Protocol

Features:

  • 🕐 30-second timeouts with exponential backoff
  • 🔄 Automatic retries for network issues
  • 📏 Response limiting prevents context overflow
  • 🎯 Request deduplication for efficiency

🎯 Example Usage

// Get service overview get_project_structure() // Explore weapons folder get_project_structure("game.ServerStorage.Weapons", maxDepth=2) // Find all Sound objects search_by_property("ClassName", "Sound") // Check script dependencies get_dependencies("game.ServerScriptService.MainScript") // Find broken references validate_references() // Get UI component details get_instance_properties("game.StarterGui.MainMenu.SettingsFrame")

🔧 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!

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An AI-powered server that provides access to Roblox Studio data through a plugin architecture, enabling AI tools to interact with file systems, studio context, properties, and project structure.

  1. ⚡ Quick Start (One Command)
    1. 🔌 Studio Plugin Setup (Required)
      1. 🏗️ Architecture Overview
        1. Key Components:
      2. 🛠️ 15 Powerful AI Tools
        1. 📁 File System Tools
        2. 🎯 Studio Context Tools
        3. 🔍 Instance & Property Tools
        4. 🏢 Project Analysis Tools
      3. 🧠 AI-Optimized Features
        1. Smart Project Structure
        2. Rich Metadata
      4. 🚀 Development & Testing
        1. Commands
        2. Plugin Development
      5. 📊 Communication Protocol
        1. 🎯 Example Usage
          1. 🔧 Configuration
            1. 📄 License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
                Last updated -
                18
                25
                38
                TypeScript
                MIT License
                • Apple
              • A
                security
                F
                license
                A
                quality
                Enables interaction with the Loxo recruitment platform API, facilitating tasks such as candidate and job management, activity logging, and call queue management through AI assistants.
                Last updated -
                12
                JavaScript
              • -
                security
                F
                license
                -
                quality
                A server enabling seamless interaction between AI models and WordPress sites with secure, standardized communication using the WordPress REST API for comprehensive site management.
                Last updated -
                9
                9
                TypeScript
                • Apple
              • -
                security
                A
                license
                -
                quality
                A server that allows AI assistants to access, view, run, and manage Hex projects through a standardized interface.
                Last updated -
                Python
                AGPL 3.0
                • Linux
                • Apple

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/boshyxd/robloxstudio-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server