hope1026-roblox-mcp

Roblox MCP — MCP Server for Roblox Studio | AI Game Development with Claude, Codex, Cursor & Gemini

WROX is an MCP server that lets AI coding agents control a live Roblox Studio session — create and edit scripts, instances, terrain, lighting, assets, audio, and animations via natural language.

Action-based tool surface · Bidirectional sync · Automated playtest · Multi-place support

English | 한국어 | 日本語 | Español | Português | Bahasa Indonesia

Why WROX (Weppy Roblox MCP)?

AI coding agents like Claude, Codex, and Gemini are powerful — but they cannot see or modify anything inside Roblox Studio. The DataModel, scripts, terrain, and lighting are all invisible to external tools. Without a bridge, AI can only generate code snippets that you must paste manually.

WROX is a bridge between AI agents and Roblox Studio. AI directly creates and modifies instances, scripts, properties, terrain, and more inside Studio, and the changes are reflected immediately in Studio and the dashboard so you can see exactly what changed.

No copy-pasting code. AI does the work, you review the results.

Quick Install

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex

Then reopen your AI app and restart Roblox Studio.

Automatic MCP registration supports Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, and Antigravity.

If PowerShell execution is blocked on Windows, use the installation guide below. If you're using the ZIP package, you can run setup-plugin.sh / setup-mcp.sh on macOS or Linux, or setup-plugin.bat / setup-mcp.bat on Windows.

Manual Install

If the one-line install does not work, or automatic installation is not available in your environment, use the installation guide below.

Step 1 — Install the Roblox Studio plugin (bridge between Studio and AI): Plugin Installation Guide

Step 2 — Register the MCP server with your AI app:

npx -y @weppy/roblox-mcp

AI App	Guide
Claude Code	Setup
Claude Desktop	Setup
Cursor	Setup
Codex CLI	Setup
Codex Desktop	Setup
Gemini CLI	Setup
Antigravity	Setup

Any MCP-compatible AI client works. The server command is npx -y @weppy/roblox-mcp.

Compatibility

Claude Code	Claude Desktop	Cursor	Codex CLI	Gemini CLI	Antigravity
✅	✅	✅	✅	✅	✅

Requirements: Node.js 18+, Roblox Studio, Windows 10+ or macOS 12+

What It Does

1) MCP Tools: Direct execution in Studio from natural language

AI can directly handle scripts, instances, properties, terrain, lighting, assets, audio, and animation inside Studio.

• "Add particles + sound + cooldown when the player jumps."
• "Build a boss arena at map center and place collision-safe spawn points."
• "Change this module interface and update every dependent script."
• "Generate terrain with mountains and rivers, then place spawn points on flat areas."
• "Search the Creator Store for a sword model and insert it into StarterPack."

2) Sync: Keep full project context stable for AI

AI works from a synchronized local mirror, so multi-file updates stay consistent.

• Basic: one-way sync (Studio -> Local)
• Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place

3) Playtest: Let AI run and verify tests automatically

AI can control Roblox Studio playtests directly. It can start and stop Play (F5) or Run (F8), inject test scripts, collect logs, and generate local reports automatically.

• "Start a Run-mode playtest and check whether the NPC reaches the target."
• "Write a test that verifies the SpawnLocation is above the ground and run it."
• "Validate that the script I just changed runs without errors in playtest."

4) WROX Dashboard: Monitor AI work in real time