Roblox Luau

v1.0.0Developer Toolsstable

Luau language server and VS Code extension for Roblox, with strict type checking, smart completions, and optional live-game tooling via an executor bridge.

code-intelligencedeveloper-toolsdiagnosticsintellisenselanguage-server
Share:
16
Stars
0
Downloads
0
Weekly
0/5

What is Roblox Luau?

Roblox Luau is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to luau language server and vs code extension for roblox, with strict type checking, smart completions, and optional live-game tooling via an executor bridge.

Luau language server and VS Code extension for Roblox, with strict type checking, smart completions, and optional live-game tooling via an executor bridge.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Luau language server and VS Code extension for Roblox, with

Use Cases

Get strict type checking and smart completions for Roblox Luau code.
Debug diagnostics and language intelligence for game development.
Execute live game tooling with the executor bridge.
0neShot101

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 11, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx rbxdev-ls

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Roblox Luau

rbxdev-ls is a Luau language server and VS Code extension for Roblox development that provides strict type checking, intelligent completions based on the official Roblox API, and over 30 language protocol handlers. Its standout feature is an executor bridge over WebSocket that connects the editor to a live Roblox game, enabling instance tree browsing, property reading and writing, in-game code execution, remote event monitoring, and console log access — all from within VS Code or an AI assistant via MCP.

Prerequisites

  • Node.js 16+ and npm for the standalone MCP server (npx -y @oneshot101/rbxdev-mcp)
  • VS Code (optional) if using the editor extension alongside the MCP server
  • A Roblox game open in Roblox Studio or a live game for executor bridge features
  • A Roblox executor capable of running the provided Lua bridge script (for live-game tools)
  • An MCP client such as Claude Desktop or Cursor
1

Install the MCP server package

Install the rbxdev MCP server globally or use npx to run it on demand. The package name on npm is @oneshot101/rbxdev-mcp.

npm install -g @oneshot101/rbxdev-mcp
# or use without global install:
npx -y @oneshot101/rbxdev-mcp
2

Configure the MCP client

Add the rbxdev MCP server to your MCP client's configuration file. The optional RBXDEV_BRIDGE_PORT variable overrides the default WebSocket port (21324) if it conflicts with other services.

{
  "mcpServers": {
    "rbxdev-ls": {
      "command": "npx",
      "args": ["-y", "@oneshot101/rbxdev-mcp"],
      "env": {
        "RBXDEV_BRIDGE_PORT": "21324"
      }
    }
  }
}
3

Set up the in-game executor bridge

To use live-game tools, run the executor bridge script inside your Roblox game. Execute the following Lua code in your Roblox executor to establish the WebSocket connection to the MCP server.

loadstring(game:HttpGetAsync(
  'https://raw.githubusercontent.com/0neShot101/rbxdev-ls/main/scripts/executor-bridge.lua'
))()
4

Verify the bridge connection

After running the bridge script, use the MCP tool 'check bridge status' or ask your AI assistant to verify the executor bridge is connected. The bridge status resource reports connection state.

5

Use live-game tools via AI prompts

With the bridge running, your AI assistant can browse the instance tree, read/write properties, execute Luau code in-game, and spy on remote events — all through the 19 MCP tools exposed by the server.

Roblox Luau Examples

Client configuration

Full Claude Desktop configuration for the rbxdev MCP server with default bridge port.

{
  "mcpServers": {
    "rbxdev-ls": {
      "command": "npx",
      "args": ["-y", "@oneshot101/rbxdev-mcp"],
      "env": {
        "RBXDEV_BRIDGE_PORT": "21324"
      }
    }
  }
}

Prompts to try

Example prompts for Roblox development and live-game interaction via rbxdev-ls.

- "Browse the instance tree of my live Roblox game and list all Script objects under ServerScriptService."
- "Read the 'WalkSpeed' property of the player's Humanoid in the live game."
- "Execute this Luau code in my Roblox game: print('Hello from AI')"
- "Monitor incoming RemoteEvent calls and show me what data is being sent from clients."
- "Decompile the LocalScript named 'UIController' and show me its source code."

Troubleshooting Roblox Luau

The executor bridge fails to connect or times out

Ensure the Roblox game has HttpEnabled set to true in game settings (required for HttpGetAsync). Also verify that port 21324 (or your custom RBXDEV_BRIDGE_PORT) is not blocked by a firewall. The bridge script must be re-run each time the game restarts.

MCP tools show as unavailable after configuration

Run 'npx -y @oneshot101/rbxdev-mcp' in a terminal to confirm the package resolves correctly and check for Node.js version compatibility. Restart the MCP client after confirming it runs successfully.

Code execution in-game fails with permission errors

The executor bridge requires a Roblox executor with script injection capabilities, which only works in certain contexts (not in standard Roblox Studio play-test mode). Ensure you are using a compatible executor and that the bridge script ran without errors.

Frequently Asked Questions about Roblox Luau

What is Roblox Luau?

Roblox Luau is a Model Context Protocol (MCP) server that luau language server and vs code extension for roblox, with strict type checking, smart completions, and optional live-game tooling via an executor bridge. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Roblox Luau?

Follow the installation instructions on the Roblox Luau GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Roblox Luau?

Roblox Luau works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Roblox Luau free to use?

Yes, Roblox Luau is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "rbxdev-ls": { "command": "npx", "args": ["-y", "rbxdev-ls"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Roblox Luau?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides