weppy-roblox-mcp

Overview

WEPPY is an MCP server that bridges AI coding agents with Roblox Studio, allowing direct creation and editing of scripts, instances, terrain, lighting, assets, and more. It features bidirectional project synchronization, automated playtesting, and a dashboard for monitoring AI actions in real-time. The server supports multiple AI clients including Claude Code, Claude Desktop, Cursor, Codex, and Gemini, with both one-click installation and manual configuration options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• create_instance

  Creates new instances in Roblox Studio with specified properties

  Try:Add particles + sound + cooldown when the player jumpsTry:Build a boss arena at map center
• modify_properties

  Modifies properties of existing Roblox Studio instances

  Try:Change this module interface and update every dependent scriptTry:Place collision-safe spawn points
• generate_terrain

  Generates terrain with mountains, rivers, and other features in Roblox Studio

  Try:Generate terrain with mountains and riversTry:Create flat areas for spawn points
• manage_assets

  Searches Creator Store and manages asset insertion in Roblox Studio

  Try:Search the Creator Store for a sword model and insert it into StarterPackTry:Add new game assets to the project
• start_playtest

  Starts and manages playtests in Roblox Studio with custom test scripts

  Try:Start a Run-mode playtest and check whether the NPC reaches the targetTry:Validate that the script runs without errors
• create_ui

  Creates and modifies in-game UI elements in Roblox Studio

  Try:Create a game-style menu with buttons and labelsTry:Design a HUD with health bar and score display
• sync_project

  Synchronizes Roblox Studio project with local files

  Try:Sync the current project stateTry:Update local files with changes from Studio
• search_instances

  Searches for specific instances in Roblox Studio based on criteria

  Try:Find all scripts with the 'jump' functionalityTry:Locate all spawn points in the map
• manage_audio

  Manages audio and sound effects in Roblox Studio

  Try:Add background music to the game menuTry:Create a sound effect for jumping
• create_animation

  Creates and manages animations in Roblox Studio

  Try:Create a walking animation for the characterTry:Design an attack animation for the boss

Note: Tool names inferred from use cases and descriptions in the README, as there isn't a dedicated 'Tools' section. The README describes functionality through examples rather than explicit tool definitions.

Comparable tools

Installation

# 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

npx -y @weppy/roblox-mcp@latest

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

FAQ

How do I connect Claude Code to Roblox Studio?

Install from the web install page or add the WEPPY Roblox AI Toolkit for Claude Code using the commands provided. The WEPPY Roblox AI Toolkit uses 'npx -y @weppy/roblox-mcp@latest' as the MCP server command.

Can AI build complete Roblox games with this server?

Yes. AI can create instances, write scripts, generate terrain, set up lighting, insert assets, configure physics, and more - all inside a live Roblox Studio session. It goes beyond code generation to executable actions.

Compare weppy-roblox-mcp with