roblox-studio-mcp-server

HashiraStudios/roblox-studio-mcp-server

3.1

If you are the rightful owner of roblox-studio-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Roblox Studio MCP Server facilitates integration between Roblox Studio and AI assistants like Claude Code, enabling real-time communication and manipulation of game objects.

Tools
12
Resources
0
Prompts
0

Roblox Studio MCP Server

MCP (Model Context Protocol) server for Roblox Studio integration with Claude Code and other AI assistants.

Features

  • 🔧 12 Powerful Tools for manipulating Roblox Studio
  • 🚀 Real-time Communication via long polling
  • 🔒 Secure local-only connections
  • 📝 Full TypeScript support
  • 🎯 Claude Code optimized

Tools Available

ToolDescription
get_project_structureView game object hierarchy
read_script_sourceRead script source code
write_script_sourceWrite/update script code
create_objectCreate new instances
delete_objectDelete objects
find_object_by_pathFind object by path
find_objects_by_classFind all objects of a class
get_propertiesRead object properties
set_propertiesSet object properties
run_codeExecute Luau code
focus_on_objectFocus Studio camera
get_camera_infoGet camera information

Requirements

Installation

npm install -g roblox-studio-mcp-server

Or install locally:

git clone https://github.com/HashiraStudios/roblox-studio-mcp-server.git
cd roblox-studio-mcp-server
npm install
npm run build

Configuration

For Claude Code

Create or edit .mcp.json in your Roblox project root:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "node",
      "args": ["/path/to/roblox-studio-mcp-server/dist/index.js"],
      "enabled": true
    }
  }
}

Environment Variables

  • HTTP_PORT: HTTP server port (default: 3000)
  • HTTP_HOST: HTTP server host (default: 127.0.0.1)
  • POLL_TIMEOUT: Long polling timeout in ms (default: 30000)
  • LOG_LEVEL: Logging level (default: info)

Usage

1. Start the Server

npm start

Or for development:

npm run dev

2. Connect Roblox Studio Plugin

  1. Open Roblox Studio
  2. Install the Roblox Studio MCP Plugin
  3. Click the plugin button in the toolbar
  4. Click "Connect" (default: http://localhost:3000)

3. Use with Claude Code

claude

Then try commands like:

  • "Show me the project structure"
  • "Create a red Part named TestPart in Workspace"
  • "Read the MainScript in ServerScriptService"
  • "Set the Position of Workspace.TestPart to 0, 10, 0"

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run tests
npm test

Architecture

┌─────────────────┐
│  Claude Code    │
│   (MCP Client)  │
└────────┬────────┘
         │ STDIO
         │
┌────────▼────────┐
│   MCP Server    │
│   (Node.js)     │
└────────┬────────┘
         │ HTTP
         │
┌────────▼────────┐
│ Roblox Studio   │
│    Plugin       │
└─────────────────┘

Troubleshooting

Plugin not connecting

  1. Check if HTTP server is running: curl http://localhost:3000/health
  2. Verify HttpService is enabled in Roblox Studio
  3. Check firewall settings

Commands timing out

  1. Increase POLL_TIMEOUT environment variable
  2. Check Studio Output for plugin errors
  3. Verify plugin is connected (green status)

STDIO errors

  1. Ensure no console.log() or print() statements in code
  2. All logging goes to stderr via pino
  3. Check Claude Code logs for errors

Contributing

Contributions are welcome! Please read for details.

License

MIT License - see for details.

Links

Support