Getting Started

Using Roblox MCP requires two components.

AI app (Claude, Codex, Gemini, etc.)
       │
   MCP Server  ← Translates AI commands into a form Roblox understands
       │
Roblox Studio Plugin  ← Executes commands inside Studio

When your AI app says “create a blue Part,” the MCP server translates the request and the Roblox Studio plugin actually creates the Part.

One-Line Install (Recommended)

Run the single command below to install both the MCP server and the plugin at once.

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

After installation, reopen your AI app and restart Roblox Studio.

If an error occurs during installation, the path to a temporary log file is printed. In interactive mode, the console stays open before exiting so you can see the cause.

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

If PowerShell execution is blocked on Windows, proceed with manual installation below. When using the ZIP package, you can run setup-plugin.bat and setup-mcp.bat.

Manual Installation

An alternative procedure if the one-line install doesn’t work or automatic installation isn’t available in your environment.

Step 1 — Install the Roblox Studio Plugin

Download the plugin file from GitHub and place it in the Roblox Studio Plugins folder.

Step 2 — Register the MCP Server in Your AI App

Choose your AI app and follow its setup guide. WEPPY works with any AI app that supports MCP.

Even if your AI app isn’t listed above, you can use it as long as it supports MCP. The MCP server command is npx -y @weppy/roblox-mcp.

Optional — WEPPY Roblox Explorer (VSCode Extension)

Browse the synced instance tree with Roblox class icons right inside VSCode. This extension requires the Roblox MCP installation above to be completed first, since Explorer reads the weppy-project-sync sync data under your project root.

After Installation

1. Open Roblox Studio and click WEPPY → Connect in the Plugins tab.

2. Test it from your AI app:

   Create a blue Part in Roblox Studio

3. If the Part is created successfully, the installation is complete.