Vibe Blocks MCP for Roblox Studio

Connects Roblox Studio to AI coding editors (like Cursor, Windsurf, Claude, etc) via the Model Context Protocol (MCP), enabling AI-assisted game development within your Roblox Studio environment.

Overview

This project consists of two main parts:

1. Python MCP Server: A FastAPI server that runs locally. It exposes Roblox Studio actions as tools over MCP (using Server-Sent Events - SSE). It can optionally interact with Roblox Open Cloud APIs if configured.
2. Lua Companion Plugin: A Roblox Studio plugin (roblox_mcp_plugin/src/Plugin.server.lua) that runs inside Studio. It polls the local Python server for commands, executes them in the Studio context (manipulating instances, reading properties, executing Luau), and sends results and Studio logs back to the server.

This allows an AI agent connected via MCP to understand and interact with your live Roblox Studio session.

Features

• Live Studio Interaction:
  • Scene Manipulation: Create, delete, clone, move, scale, and set properties (including PrimaryPart) of objects (Parts, Models, Scripts, etc.) directly in the Studio scene.
  • Scene Inspection: Get object properties, list children, find instances by class or name within Studio.
  • Scripting: Create, edit, and delete Scripts/LocalScripts. Execute arbitrary Luau code directly within the Studio environment and capture output/errors.
  • Environment: Set properties on Lighting or Terrain services.
  • Animation: Play animations on Humanoids/AnimationControllers.
  • NPCs: Spawn NPCs by cloning existing templates or inserting from Asset IDs.
  • Modify Children: Apply property changes to multiple children of an object based on filters.
  • Studio Logs: Retrieve recent logs from the Studio Output window.
• Roblox Open Cloud Integration (Optional - Requires API Key):
  • Luau Execution (Cloud): Run Luau code in a separate cloud environment (useful for tasks not requiring live Studio access).
  • DataStores: List stores, get, set, and delete key-value entries in standard DataStores.
  • Assets: Upload new assets (Models, Images, Audio) from local files.
  • Publishing: Publish the currently saved or published version of a place.
  • (Planned): Get asset details, list user assets.

Setup

1. Prerequisites:

• Python >= 3.10
• uv package manager (Install uv). This is highly recommended for faster dependency management.
• Roblox Studio
• (Optional) A Roblox API Key for Open Cloud features. Get one from Roblox Creator Dashboard > Credentials. You’ll need permissions for the APIs you intend to use (DataStore, Asset Upload, Publishing, Luau Execution etc.).
• (Optional) Your Roblox Universe ID and the target Place ID (needed for Open Cloud features).