Weppy Roblox

v1.0.0APIsstable

Roblox Studio MCP server & plugin for Claude Code, Cursor, Codex, and Gemini. AI-powered scripts, terrain, assets, lighting, and bidirectional project sync.

aiai-agentsantigravityclaudeclaude-code
Share:
24
Stars
0
Downloads
0
Weekly
0/5

What is Weppy Roblox?

Weppy Roblox is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to roblox studio mcp server & plugin for claude code, cursor, codex, and gemini. ai-powered scripts, terrain, assets, lighting, and bidirectional project sync.

Roblox Studio MCP server & plugin for Claude Code, Cursor, Codex, and Gemini. AI-powered scripts, terrain, assets, lighting, and bidirectional project sync.

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

Features

  • Roblox Studio MCP server & plugin for Claude Code, Cursor, C

Use Cases

Roblox Studio integration
Script and asset automation
Bidirectional project sync
hope1026

Maintainer

LicenseAGPL-3.0
Languagepowershell
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx weppy-roblox

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 Weppy Roblox

Weppy Roblox MCP Server is a bridge between AI coding agents and Roblox Studio, allowing Claude Code, Cursor, Codex, and Gemini to directly control Roblox Studio through natural language. It installs as both an MCP server and a Roblox Studio plugin, enabling agents to create and modify scripts, generate terrain, manage instance hierarchies, configure lighting and atmosphere, insert assets from the Creator Store, and run automated playtests — all through conversational AI prompts. This dramatically accelerates Roblox game development by letting developers describe what they want and having AI implement it directly in Studio.

Prerequisites

  • Node.js 18+ installed
  • Roblox Studio installed (Windows 10+ or macOS 12+)
  • An MCP-compatible AI client: Claude Code, Claude Desktop, Cursor, Codex, or Gemini CLI
  • The Weppy Roblox plugin installed inside Roblox Studio (installed via the setup process)
1

Install the MCP server (macOS/Linux)

Run the one-line installer script which sets up both the MCP server and prompts you to install the Roblox Studio plugin.

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

Install the MCP server (Windows PowerShell)

On Windows, use PowerShell to run the equivalent installer script.

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

Add to MCP client configuration

Configure the Weppy Roblox MCP server in your AI client. The npx command auto-downloads and runs the latest version.

{
  "mcpServers": {
    "weppy-roblox": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"],
      "env": {
        "ENABLE_TELEMETRY": "false"
      }
    }
  }
}
4

Install the Roblox Studio plugin

Open Roblox Studio and install the Weppy Roblox plugin from the Creator Store or via the plugin marketplace link provided during server setup. The plugin is required to enable bidirectional communication.

5

Connect Studio to the MCP server

In Roblox Studio, activate the Weppy plugin from the Plugins tab. It will establish a connection to the running MCP server. You should see a 'Connected' status in the plugin panel.

6

Start building with AI

With Studio connected, open your AI client (Claude Code, Cursor, etc.) and start issuing natural language instructions to modify your Roblox game.

Weppy Roblox Examples

Client configuration

Claude Desktop configuration for the Weppy Roblox MCP server using the npm package.

{
  "mcpServers": {
    "weppy-roblox": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"],
      "env": {
        "ENABLE_TELEMETRY": "false"
      }
    }
  }
}

Prompts to try

Example prompts for controlling Roblox Studio through the Weppy MCP server.

- "Add particles, a sound effect, and a cooldown timer when the player jumps"
- "Build a boss arena with collision-safe spawn points around the perimeter"
- "Generate procedural terrain with mountains and rivers across a 512x512 stud area"
- "Search the Creator Store for a sword model and insert it into StarterPack"
- "Set up realistic lighting with an atmosphere object and time-of-day cycle"

Troubleshooting Weppy Roblox

Roblox Studio plugin shows 'Disconnected' even after starting the MCP server

Ensure the MCP server is running (run npx -y @weppy/roblox-mcp@latest in a terminal to test). The plugin and server communicate on a local port — check that no firewall or antivirus is blocking localhost connections.

npx command fails with a Node.js version error

Weppy Roblox requires Node.js 18 or higher. Run node --version to check and upgrade if needed via nvm install 18 && nvm use 18.

AI agent can see Studio but changes don't appear

Make sure you activated the Weppy plugin inside Roblox Studio from the Plugins ribbon tab. The plugin must be actively running in Studio for the bidirectional sync to work.

Frequently Asked Questions about Weppy Roblox

What is Weppy Roblox?

Weppy Roblox is a Model Context Protocol (MCP) server that roblox studio mcp server & plugin for claude code, cursor, codex, and gemini. ai-powered scripts, terrain, assets, lighting, and bidirectional project sync. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Weppy Roblox?

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

Which AI clients work with Weppy Roblox?

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

Is Weppy Roblox free to use?

Yes, Weppy Roblox is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

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

Quick Config Preview

{ "mcpServers": { "weppy-roblox": { "command": "npx", "args": ["-y", "weppy-roblox"] } } }

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

Read the full setup guide →

Ready to use Weppy Roblox?

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