Roblex Studio MCP Server implements the Model-Context-Protocol to enable AI-driven scripting workflows inside Roblox Studio. It runs as a standalone Node.js-based MCP server that can be launched quickly with npx roblex-mcp, automatically starting Roblox Studio on supported platforms and providing a transport layer (SSE or STDIO) for tools and clients. The server exposes core MCP features, supports Claude Desktop and Open Cloud integrations, and includes security and input sanitization to help maintain safe automation. You can extend the server by placing custom tools and resources under src/tools and src/resources, enabling scripted interactions with Roblox assets, universe data, and AI-generated content via the MCP protocol.

Prerequisites:

• Node.js 18 or higher (Node.js 20+ recommended)
• Roblox Studio installed (Windows; if you want automatic launch)
• npm (bundled with Node.js)

Installation and startup:

1. Ensure Node.js and npm are installed. Verify with: node -v npm -v

2. Run the MCP server directly with npx (no local install required): npx roblex-mcp

   This will pull the roblex-mcp package and start the server. On first run, the server will attempt to launch Roblox Studio if available.

3. Optional: clone the repository and install locally for development (if you prefer): git clone https://github.com/dmae97/roblex-studio-mcp-server.git cd roblex-studio-mcp-server npm install npm run build npm start

4. Configure environment variables for full functionality by copying the example file and editing as needed: cp .env.example .env

   Edit .env to set ROBLOX_API_KEY, ROBLOX_OPEN_CLOUD_API_KEY, ROBLOX_STUDIO_PATH, etc.

Notes:

• If Roblox Studio is not in a standard location, set ROBLOX_STUDIO_PATH in the .env file.
• Use npx roblex-mcp for quick startup without local installation; for development, use npm start after building.

Tips and common considerations:

• Environment variables control most behavior. Ensure ROBLOX_API_KEY and ROBLOX_OPEN_CLOUD_API_KEY are valid and kept secret.
• PORT and TRANSPORT_MODE can be adjusted in .env to fit your environment; default is port 3001 and stdio transport.
• CLAUDE_DESKTOP_ENABLED should be true if you want Claude Desktop integration; ensure Claude Desktop is installed and running when enabling this.
• If you encounter Roblox Studio launch issues, verify ROBLOX_STUDIO_PATH points to the correct RobloxStudioBeta.exe path and that Roblox Studio is installed.
• When developing custom tools/resources, place them under src/tools and src/resources and rebuild if you run from source.
• For troubleshooting, consult the README’s Troubleshooting section and ensure API keys have necessary permissions.