Roblox Luau
Luau language server and VS Code extension for Roblox, with strict type checking, smart completions, and optional live-game tooling via an executor bridge.
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
Maintainer
Works with
Installation
Manual Installation
npx rbxdev-lsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
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
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-mcpConfigure 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"
}
}
}
}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'
))()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.
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.
Roblox Luau Alternatives — Similar Developer Tools Servers
Looking for alternatives to Roblox Luau? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
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.
Set Up Roblox Luau in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
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.