MCPBridge
Provides tools for interacting with Blender, enabling AI agents to manage scenes, objects, and perform 3D modeling operations.
Provides tools for interacting with Roblox Studio, enabling AI agents to manage scripts, execute Lua code, and manipulate workspace elements.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCPBridge
Connect Claude Code and Ollama to Roblox Studio and Blender via the Model Context Protocol
Claude Code (stdio)
│ MCP protocol
▼
MCP Server ──── HTTP :7842 ───► Roblox Studio Plugin (Lua)
│
├──── HTTP :7843 ───► Blender Plugin (Python)
│
└── Ollama API (:11434) ──► minimax-m2.5:cloud⚙️ Prerequisites - Required for Everyone
These steps are required regardless of your platform or install method.
1 - Download the source
Click Code → Download ZIP at the top of this page and extract it somewhere on your machine.
The ZIP includes MCPBridge.exe, the Windows setup app, in the top folder. Leave it where it is:
it finds mcp-server/index.js and roblox-plugin/OllamaMCP.lua next to itself.
On macOS there is no setup app at the moment: follow Manual Setup below (two small steps).
2 - Install Node.js via NVM
Download and run nvm-setup.exe from the nvm-windows releases page, then open a new terminal and run:
nvm install lts
nvm use ltsThis installs the latest Node.js LTS release and sets it as your active version.
Install nvm by running the install script in your terminal:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bashThen restart your terminal (or run source ~/.zshrc), and run:
nvm install --lts
nvm use --lts
nvm alias default 'lts/*'This installs the latest Node.js LTS release and sets it as your default.
3 - No npm install needed
Since v1.1 the MCP server has no dependencies: it runs with Node.js alone. If you look in
mcp-server/ and find nothing to install, that is correct. Skip straight to the next step.
To check that Node.js works, run this from the extracted folder. It should print
MCPBridge 1.1.0 ready and then wait (press Ctrl+C to stop it):
node mcp-server/index.js4 - Enable Studio as MCP Server
To enable the MCP server in Studio:
Open Assistant
Click ... → Manage MCP Servers
Turn on Enable Studio as MCP server
Related MCP server: BlenderMCP
🚀 Quick Install
Launch
MCPBridge.exefrom the extracted folderIf
index.jsorOllamaMCP.luaweren't auto-detected, press Browse and select them manuallyClick Apply Changes - this writes a single
mcpbridgeentry to yourclaude.jsonand installs the Roblox plugin automaticallyRoblox Studio: click Launch Studio in the app, or open it manually
Blender: select your install from the dropdown and click Launch Blender, then install the addon once (see Blender Plugin Setup)
Exit MCPBridge, then launch Claude Code via Ollama:
ollama launch claude --model minimax-m2.5:cloudStart giving Claude prompts and watch it work!
There is no macOS setup app at the moment. Use Manual Setup: add the mcpbridge
entry to ~/.claude.json and copy OllamaMCP.lua into Studio's plugins folder.
🔌 Blender Plugin Setup
The Blender plugin is installed manually once directly inside Blender. You only need to do this the first time.
Open Blender
Go to Edit → Preferences → Add-ons
Click Install from Disk…
Select
MCPBridge/blender-plugin/MCPBridge.pyfrom the extracted source folderEnable MCPBridge in the add-ons list
Once enabled, open any 3D Viewport, open the Sidebar (N key), go to the MCPBridge tab, and click Start Bridge. The status indicator will turn green when connected.
The Blender plugin connects tolocalhost:7843. Make sure the MCPBridge MCP server is running (i.e. Claude Code has it active) before clicking Start Bridge.
📦 Manual Setup
1 - Configure Claude Code
Add the MCP server to Claude Code's config. The config file lives at:
OS | Path |
macOS |
|
Windows |
|
MCPBridge uses a single unified server that handles both Roblox and Blender. Add or merge one of the blocks below.
Option A - from npm (recommended). npx fetches and runs the server:
{
"mcpServers": {
"mcpbridge": {
"command": "npx",
"args": ["-y", "@iamjrmh/mcpbridge@latest"]
}
}
}Option B - from local source. Use this if you downloaded the repo (replace the path with your actual path; no npm install needed):
{
"mcpServers": {
"mcpbridge": {
"command": "node",
"args": ["/absolute/path/to/MCPBridge/mcp-server/index.js"]
}
}
}Then restart Claude Code. You should see mcpbridge in your MCP tools list with all Roblox and Blender tools available.
The npm package@iamjrmh/mcpbridge contains the MCP server only. You still need the source's roblox-plugin/ and blender-plugin/ files to install the Studio and Blender plugins.
If you have oldroblox-ollama or blender-mcp entries in your claude.json from a previous version, remove them. Having multiple entries pointing at the same index.js will cause both to fail (port conflict on :7842). The MCPBridge app's Apply Changes button handles this migration automatically.
2 - Install the Roblox Studio Plugin
Open Roblox Studio
Go to Plugins → Plugin Folder (opens a folder in your file explorer)
Copy
roblox-plugin/OllamaMCP.luainto that folderRestart Roblox Studio
The "MCP Bridge" button appears in the Plugins toolbar
To enable the MCP server in Studio:
Open Assistant
Click ... → Manage MCP Servers
Turn on Enable Studio as MCP server
3 - Install the Blender Plugin
See Blender Plugin Setup above.
4 - Start Ollama
Pick a model and launch it with Ollama. The bridge calls the REST API at http://localhost:11434 automatically.
Recommended models:
# Balanced cloud model (default)
ollama launch claude --model minimax-m2.5:cloud
# Newer cloud model
ollama launch claude --model minimax-m2.7:cloud
# General purpose
ollama launch claude --model qwen3.5
# Coding focused
ollama launch claude --model qwen3-coder
# Lightweight / fast
ollama launch claude --model gemma45 - Connect everything
In Roblox Studio, click "MCP Bridge" in the toolbar - widget shows 🟢 Connected
In Blender, open the MCPBridge sidebar tab and click Start Bridge - status shows 🟢 Connected
Open Claude Code in your terminal
Start asking Claude to work on your Roblox scripts or Blender scene!
🛠 Available MCP Tools
studio_execute_lua and blender_execute_python can do anything the application's own
scripting API allows. The other tools are shortcuts for the common jobs.
Studio Tools (Roblox)
Tool | Description |
| Is the Studio plugin connected, and what to do if not |
| Run any Luau in Studio; returns values, printed output and errors |
| Instance tree under a path |
| Search by name and/or class |
| Read an instance's properties, attributes and tags |
| Change properties, attributes and tags on one or many instances |
| Create any class, with properties and nested children |
| Delete instances (undoable) |
| Copy an instance, optionally to a new parent |
| Reparent and/or rename an instance |
| Insert a marketplace asset by id |
| List scripts with class and line count |
| Read a script's source |
| Replace a script's source (creates it if missing) |
| Replace one piece of text inside a script |
| Create a Script, LocalScript or ModuleScript |
| Recent Output window lines (prints, warnings, errors) |
| Place name and ids, counts, playtest state |
| What is selected in the Explorer |
| Select instances, to show the user what changed |
| Step Studio's undo history |
Property values are plain JSON: Vector3 [x,y,z], Color3 "#RRGGBB", CFrame
{"position":[x,y,z],"rotation":[rx,ry,rz]}, UDim2 [xs,xo,ys,yo], enums by name, instances by path.
Blender Tools
Tool | Description |
| Is the Blender add-on connected, and what to do if not |
| Run any Python (bpy) in Blender; returns the last expression, printed output and errors |
| Scene objects, active object, render settings |
| One object's transform, mesh counts, materials, modifiers |
| Recent lines printed through MCPBridge |
| Text blocks in the .blend file |
Ollama Tools
Tool | Description |
| Models available in the local Ollama |
| Any prompt (with optional system prompt and options) to a model |
| Generate Roblox Luau for a task, optionally write it to Studio |
| Review a Studio script for bugs and performance |
| Generate Blender Python for a task, optionally run it |
Every tool that runs something takes timeout_seconds (default 60, up to 600) for long jobs.
Prompts
Reusable, parameterised workflows exposed over MCP - invoke them from any MCP client.
Prompt | Arguments | Purpose |
|
| Plan and implement a Roblox feature end-to-end |
|
| Diagnose and fix a misbehaving script |
|
| Review a script for bugs and performance |
|
| Plan and build a Blender scene with |
Resources
Readable context data exposed over MCP - attach them to a conversation for live state.
Resource URI | Description |
| Agent skill guide ( |
| Server version, ports, default model, capability counts |
| Live Roblox Studio connection state |
| Recent Roblox Studio output log |
| Live Blender connection state |
| Recent Blender output log |
💬 Example Prompts
Roblox Studio:
"List all scripts in my Roblox game"
"Read the source of game.ServerScriptService.GameManager"
"Generate a Roblox Lua leaderboard system and write it to game.ServerScriptService.Leaderboard"
"Review game.StarterPlayer.StarterCharacterScripts.Movement for performance issues"
"Create a new LocalScript called 'UIHandler' in game.StarterPlayer.StarterPlayerScripts"Blender:
"What objects are in my Blender scene?"
"Add a subdivided cube at the origin with 3 levels of subdivision"
"Generate a Python script to create a low-poly tree and execute it in Blender"
"Select all mesh objects in the scene and apply a smooth shading modifier"
"What is the current render engine and frame range?"🔧 Troubleshooting
This was a bug in v1.0 (issue #1). The MCP server kept
running after its Claude Code session closed and held on to ports 7842 / 7843. The plugin kept talking
to that leftover server (so it showed Connected) while the server of your new session could not open the
ports, so its tools all failed.
Fix:
Update to v1.1: replace
mcp-server/index.jsandroblox-plugin/OllamaMCP.lua(and the Blender add-on) with the new files. If you use npx, set the args to["-y", "@iamjrmh/mcpbridge@latest"]so it always runs the newest server.Close Claude Code, then end any leftover
node(Windows:node.exe) processes in Task Manager / Activity Monitor once.Start Claude Code again and ask it to run
studio_status.
From v1.1 on, the server exits with its session, several sessions can be open at once (they share the connection), and a tool that cannot reach the plugin says why within a few seconds.
Correct: since v1.1 the server has no dependencies, so there is no npm install step. You only need Node.js 18 or newer.
The MCP server only runs while your AI coding session (Claude Code) is open with
mcpbridgein its configAsk the agent to run
studio_status; its answer says what is wrongIf Studio asked whether the plugin may make HTTP requests to
127.0.0.1, allow it (Plugins > Manage Plugins)Check that port
7842isn't blocked by a firewall
The MCP server only runs while your AI coding session is open with
mcpbridgein its configCheck that port
7843isn't blocked by a firewallConfirm the MCPBridge addon is enabled in Edit → Preferences → Add-ons
Try clicking Stop Bridge then Start Bridge again in the sidebar
Something that is not MCPBridge is using port 7842 or 7843. Close that program, or (for old setups) remove
leftover roblox-ollama / blender-mcp entries from claude.json; the MCPBridge app's Apply Changes does that for you.
Confirm Ollama is running:
curl http://localhost:11434/api/tagsMake sure
minimax-m2.5:cloudis available in your Ollama setup
Long jobs: pass a larger
timeout_secondsto the tool (up to 600)The plugin may have been deactivated - click the toolbar/sidebar button again
Check the plugin widget for error messages
📁 File Structure
MCPBridge/
├── mcp-server/
│ ├── index.js ← Unified MCP + HTTP bridge server (Roblox :7842, Blender :7843), no dependencies
│ ├── test/ ← `node --test mcp-server/test/bridge.test.mjs`
│ └── package.json
├── roblox-plugin/
│ └── OllamaMCP.lua ← Roblox Studio plugin (auto-installed by MCPBridge app)
├── blender-plugin/
│ └── MCPBridge.py ← Blender addon (install manually via Edit → Preferences)
├── MCPBridge.exe ← Windows setup app (double-click to run)
├── claude_mcp_config.json ← Example Claude Code config snippet
├── server.json ← Official MCP Registry manifest
├── skills.md ← Agent skill guide (also served as the mcpbridge://guide resource)
├── start.sh ← Helper startup script
├── LICENSE ← MIT license
└── README.md📄 License
MCPBridge is released under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Build, run and publish 3D games in the Zero engine from Claude Code, Cursor or Codex, over MCP.
Connect AI agents to Replynodes over the Model Context Protocol.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects Blender to Claude AI through the Model Context Protocol, enabling AI-assisted 3D modeling, scene creation, and manipulation through natural language commands.172MIT
- AlicenseBqualityDmaintenanceConnects Claude AI to Blender via the Model Context Protocol to enable prompt-assisted 3D modeling, scene creation, and object manipulation. It allows users to control Blender through natural language for tasks such as modifying materials, inspecting scenes, and executing custom Python code.22MIT
- AlicenseAqualityDmaintenanceConnects Blender to Claude AI through the Model Context Protocol for AI-assisted 3D modeling, procedural geometry creation, and persistent multi-turn workflows with shared context and advanced tool chaining.304MIT
- AlicenseAqualityDmaintenanceConnects Blender to Claude AI via the Model Context Protocol, enabling natural language-driven 3D modeling, scene creation, and manipulation.22MIT