home / mcp / roblox studio mcp server v1

Roblox Studio MCP Server V1

It creates a server from port :8081 then it will receive and write code or what ever tool to the MCP!

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "alexpoopy1-roblox-studio-mcp-server-v1": {
      "command": "node",
      "args": [
        "C:\\PATH-TO-roblox-studio-mcp-server-V1\\dist\\index.js"
      ]
    }
  }
}

You run a local MCP server that connects Roblox Studio with an MCP client to send commands and manipulate the Roblox workspace in real time. This server handles the communication pipeline, loads the MCP plugin in Roblox, and executes user requests from the client, enabling interactive control and automation from your development environment.

How to use

You use the MCP server by running the local Node-based runtime and tying it to the Roblox MCP client via the provided plugin. Start the server, ensure the plugin is loaded in Roblox Studio, and then issue textual commands from the client to create, modify, or query Roblox parts and scenes during gameplay.

How to install

Prerequisites: you need Node.js installed on your machine. Ensure you have Roblox Studio installed to load the MCP plugin.

Step 1 – Install the Node server dependencies and build the project.

npm install

Step 2 – Build the server so the runtime artifacts are available for execution.

npm run build

Additional sections

Configuration for Cursor MCP is added to the settings to specify how to launch the server from the MCP client. Use the following settings to point the MCP client at the local Node process.

{
  "roblox-studio": {
    "command": "node",
    "args": [
      "C:\\PATH-TO-roblox-studio-mcp-server-V1\\dist\\index.js"
    ]
  }
}

Step 3 – Install the Roblox plugin if you have not already done so. Copy the plugin loader into Roblox Studio under ServerScriptService to enable the MCP communication.

Step 4 – Start Roblox Studio and run a test game to verify the connection. Look for the plugin loaded message and ensure the client can poll the local server at the default address.

Troubleshooting tips: if you see connection errors, ensure the Node server is running, and confirm the MCP plugin is loaded in Roblox Studio. If HTTP requests are blocked, enable Allow HTTP Requests in the Roblox Game Settings.

Notes: the final runtime command used to start the local server is the stdio entry described in the MCP configuration. If you modify paths, keep the structure intact so the runtime can locate dist/index.js.

Common flow summary: install, build, then run the local Node server and connect via the Roblox MCP plugin to begin issuing commands.

Configuration, security, and examples

The server operates locally and is designed to be launched as a standard Node.js process. Ensure your development environment is set up for Node, and that you have the correct paths to the built runtime.

Security note: when enabling HTTP requests from Roblox Studio or related tooling, ensure your environment only accepts traffic from trusted sources during development.

Available tools

Plugin Loader

Loads the MCP plugin into Roblox Studio and establishes the initial communication channel with the local MCP server.

Cursor MCP Integration

Configures Cursor MCP to launch and poll the local server, enabling real-time command execution from the MCP client.