\n\n# MCPBridge\n\n**Connect Claude Code and Ollama to Roblox Studio and Blender via the Model Context Protocol**\n\n[](https://github.com)\n[](https://github.com)\n[](https://nodejs.org)\n[](https://ollama.com)\n[](https://modelcontextprotocol.io)\n[](https://www.npmjs.com/package/@iamjrmh/mcpbridge)\n\n[](https://lobehub.com/mcp/iamjrmh-mcpbridge)\n\n
\n\n---\n\n```\nClaude Code (stdio)\n │ MCP protocol\n ▼\n MCP Server ──── HTTP :7842 ───► Roblox Studio Plugin (Lua)\n │\n ├──── HTTP :7843 ───► Blender Plugin (Python)\n │\n └── Ollama API (:11434) ──► minimax-m2.5:cloud\n```\n\n---\n\n## ⚙️ Prerequisites - Required for Everyone\n\nThese steps are required regardless of your platform or install method.\n\n### 1 - Download the source\n\nClick **Code → Download ZIP** at the top of this page and extract it somewhere on your machine.\n\nThen grab the installer for your platform from the [**Releases page**](https://github.com):\n\n
\n\nPlace the installer in the same folder as the extracted source before continuing.\n\n### 2 - Install Node.js via NVM\n\n\n🪟 Windows\n\nDownload and run **`nvm-setup.exe`** from the [nvm-windows releases page](https://github.com/coreybutler/nvm-windows/releases), then open a new terminal and run:\n\n```bash\nnvm install lts\nnvm use lts\n```\n\nThis installs the latest Node.js LTS release and sets it as your active version.\n\n\n\n\n🍎 macOS\n\nInstall [nvm](https://github.com/nvm-sh/nvm) by running the install script in your terminal:\n\n```bash\ncurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash\n```\n\nThen restart your terminal (or run `source ~/.zshrc`), and run:\n\n```bash\nnvm install --lts\nnvm use --lts\nnvm alias default 'lts/*'\n```\n\nThis installs the latest Node.js LTS release and sets it as your default.\n\n\n\n### 3 - Install server dependencies\n\nNavigate into the extracted folder and install dependencies:\n\n```bash\ncd MCPBridge/mcp-server\nnpm install\n```\n\n> [!WARNING]\n> Do not skip this step. Without it, the MCP server will not start and nothing will connect.\n\n### 4 - Enable Studio as MCP Server\n\n> [!IMPORTANT]\n> To enable the MCP server in Studio:\n> 1. Open **Assistant**\n> 2. Click **... → Manage MCP Servers**\n> 3. Turn on **Enable Studio as MCP server**\n\n---\n\n## 🚀 Quick Install\n\n\n🪟 Windows\n\n1. Launch **`MCPBridge.exe`**\n2. If `index.js` or `OllamaMCP.lua` weren't auto-detected, press **Browse** and select them manually\n3. Click **Apply Changes** - this writes a single `mcpbridge` entry to your `claude.json` and installs the Roblox plugin automatically\n4. **Roblox Studio:** click **Launch Studio** in the app, or open it manually\n5. **Blender:** select your install from the dropdown and click **Launch Blender**, then install the addon once (see [Blender Plugin Setup](#blender-plugin-setup))\n6. Exit MCPBridge, then launch Claude Code via Ollama:\n ```bash\n ollama launch claude --model minimax-m2.5:cloud\n ```\n7. Start giving Claude prompts and watch it work!\n\n\n\n\n🍎 macOS\n\n> [!NOTE]\n> On first launch macOS may show a security warning. Go to **System Settings → Privacy & Security** and click **Open Anyway** to allow it.\n\n1. Launch **`MCPBridge.pkg`**\n2. If `index.js` or `OllamaMCP.lua` weren't auto-detected, press **Browse** and select them manually\n3. Click **Apply Changes** - this writes a single `mcpbridge` entry to your `claude.json` and installs the Roblox plugin automatically\n4. **Roblox Studio:** click **Launch Studio** in the app, or open it manually\n5. **Blender:** select your install from the dropdown and click **Launch Blender**, then install the addon once (see [Blender Plugin Setup](#blender-plugin-setup))\n6. Exit MCPBridge, then launch Claude Code via Ollama:\n ```bash\n ollama launch claude --model minimax-m2.5:cloud\n ```\n7. Start giving Claude prompts and watch it work!\n\n\n\n---\n\n## 🔌 Blender Plugin Setup\n\nThe Blender plugin is installed manually once directly inside Blender. You only need to do this the first time.\n\n1. Open Blender\n2. Go to **Edit → Preferences → Add-ons**\n3. Click **Install from Disk…**\n4. Select `MCPBridge/blender-plugin/MCPBridge.py` from the extracted source folder\n5. Enable **MCPBridge** in the add-ons list\n\nOnce 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.\n\n> [!NOTE]\n> The Blender plugin connects to `localhost:7843`. Make sure the MCPBridge MCP server is running (i.e. Claude Code has it active) before clicking Start Bridge.\n\n---\n\n## 📦 Manual Setup\n\n### 1 - Configure Claude Code\n\nAdd the MCP server to Claude Code's config. The config file lives at:\n\n| OS | Path |\n|---------|-------------------------------|\n| macOS | `~/.claude.json` |\n| Windows | `%USERPROFILE%\\.claude.json` |\n\nMCPBridge uses a **single unified server** that handles both Roblox and Blender. Add or merge one of the blocks below.\n\n**Option A - from npm (recommended).** No source download or `npm install` is needed for the server; `npx` fetches and runs it:\n\n```json\n{\n \"mcpServers\": {\n \"mcpbridge\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@iamjrmh/mcpbridge\"]\n }\n }\n}\n```\n\n**Option B - from local source.** Use this if you cloned the repo and want to run your own copy (replace the path with your actual path):\n\n```json\n{\n \"mcpServers\": {\n \"mcpbridge\": {\n \"command\": \"node\",\n \"args\": [\"/absolute/path/to/MCPBridge/mcp-server/index.js\"]\n }\n }\n}\n```\n\nThen restart Claude Code. You should see `mcpbridge` in your MCP tools list with all Roblox and Blender tools available.\n\n> [!NOTE]\n> The npm package [`@iamjrmh/mcpbridge`](https://www.npmjs.com/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.\n\n> [!WARNING]\n> If you have old `roblox-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.\n\n### 2 - Install the Roblox Studio Plugin\n\n1. Open Roblox Studio\n2. Go to **Plugins → Plugin Folder** (opens a folder in your file explorer)\n3. Copy `roblox-plugin/OllamaMCP.lua` into that folder\n4. Restart Roblox Studio\n5. The **\"MCP Bridge\"** button appears in the Plugins toolbar\n\n> [!IMPORTANT]\n> To enable the MCP server in Studio:\n> 1. Open **Assistant**\n> 2. Click **... → Manage MCP Servers**\n> 3. Turn on **Enable Studio as MCP server**\n\n### 3 - Install the Blender Plugin\n\nSee [Blender Plugin Setup](#blender-plugin-setup) above.\n\n### 4 - Start Ollama\n\nPick a model and launch it with Ollama. The bridge calls the REST API at `http://localhost:11434` automatically.\n\n**Recommended models:**\n\n```bash\n# Balanced cloud model (default)\nollama launch claude --model minimax-m2.5:cloud\n\n# Newer cloud model\nollama launch claude --model minimax-m2.7:cloud\n\n# General purpose\nollama launch claude --model qwen3.5\n\n# Coding focused\nollama launch claude --model qwen3-coder\n\n# Lightweight / fast\nollama launch claude --model gemma4\n```\n\n### 5 - Connect everything\n\n1. In Roblox Studio, click **\"MCP Bridge\"** in the toolbar - widget shows 🟢 Connected\n2. In Blender, open the **MCPBridge** sidebar tab and click **Start Bridge** - status shows 🟢 Connected\n3. Open Claude Code in your terminal\n4. Start asking Claude to work on your Roblox scripts or Blender scene!\n\n---\n\n## 🛠 Available MCP Tools\n\n### Studio Tools (Roblox)\n\n| Tool | Description |\n|------|-------------|\n| `studio_status` | Check if the Roblox plugin is connected |\n| `studio_list_scripts` | List all scripts in the place |\n| `studio_read_script` | Read a script's source code |\n| `studio_write_script` | Overwrite a script's source |\n| `studio_create_script` | Create a new script instance |\n| `studio_execute_lua` | Execute Lua in the plugin context |\n| `studio_get_output` | Get recent print/warn output |\n| `studio_get_workspace_info` | Get place metadata |\n| `studio_get_selection` | Get currently selected instances |\n\n### Blender Tools\n\n| Tool | Description |\n|------|-------------|\n| `blender_status` | Check if the Blender plugin is connected |\n| `blender_execute_python` | Execute Python (bpy) code in Blender |\n| `blender_get_scene_info` | Get scene objects, active object, render settings |\n| `blender_get_output` | Get recent output captured by the plugin |\n| `ollama_generate_python` | Generate Blender Python for a task, optionally execute it |\n\n### Ollama Tools\n\n| Tool | Description |\n|------|-------------|\n| `ollama_generate` | Raw prompt → completion |\n| `ollama_generate_lua` | Generate Roblox Lua for a task, optionally write to Studio |\n| `ollama_review_script` | Review a script for bugs and performance issues |\n\n### Prompts\n\nReusable, parameterised workflows exposed over MCP - invoke them from any MCP client.\n\n| Prompt | Arguments | Purpose |\n|--------|-----------|---------|\n| `roblox_build_feature` | `feature`, `location?` | Plan and implement a Roblox feature end-to-end |\n| `roblox_debug_script` | `script_path`, `symptom?` | Diagnose and fix a misbehaving script |\n| `roblox_review_script` | `script_path`, `focus?` | Review a script for bugs and performance |\n| `blender_build_scene` | `description` | Plan and build a Blender scene with `bpy` |\n\n### Resources\n\nReadable context data exposed over MCP - attach them to a conversation for live state.\n\n| Resource URI | Description |\n|--------------|-------------|\n| `mcpbridge://guide` | Agent skill guide (`skills.md`) - tools, workflows, rules |\n| `mcpbridge://server/info` | Server version, ports, default model, capability counts |\n| `mcpbridge://studio/status` | Live Roblox Studio connection state |\n| `mcpbridge://studio/output` | Recent Roblox Studio output log |\n| `mcpbridge://blender/status` | Live Blender connection state |\n| `mcpbridge://blender/output` | Recent Blender output log |\n\n---\n\n## 💬 Example Prompts\n\n**Roblox Studio:**\n```\n\"List all scripts in my Roblox game\"\n\n\"Read the source of game.ServerScriptService.GameManager\"\n\n\"Generate a Roblox Lua leaderboard system and write it to game.ServerScriptService.Leaderboard\"\n\n\"Review game.StarterPlayer.StarterCharacterScripts.Movement for performance issues\"\n\n\"Create a new LocalScript called 'UIHandler' in game.StarterPlayer.StarterPlayerScripts\"\n```\n\n**Blender:**\n```\n\"What objects are in my Blender scene?\"\n\n\"Add a subdivided cube at the origin with 3 levels of subdivision\"\n\n\"Generate a Python script to create a low-poly tree and execute it in Blender\"\n\n\"Select all mesh objects in the scene and apply a smooth shading modifier\"\n\n\"What is the current render engine and frame range?\"\n```\n\n---\n\n## 🔧 Troubleshooting\n\n\nRoblox plugin shows 🔴 Disconnected\n\n- Make sure the MCP server is running (Claude Code must have it active)\n- Confirm HTTP requests are enabled in Studio Settings\n- Check that port `7842` isn't blocked by a firewall\n\n\n\n\nBlender plugin shows 🔴 Disconnected\n\n- Make sure the MCP server is running (Claude Code must have it active)\n- Check that port `7843` isn't blocked by a firewall\n- Confirm the MCPBridge addon is enabled in **Edit → Preferences → Add-ons**\n- Try clicking **Stop Bridge** then **Start Bridge** again in the sidebar\n\n\n\n\nBoth plugins disconnected / MCP server won't start\n\nThis is almost always caused by having duplicate entries in `claude.json` (e.g. old `roblox-ollama` and `blender-mcp` entries both pointing at `index.js`). Two Node processes fighting over port `7842` causes both to fail.\n\n**Fix:** Open MCPBridge, click **Apply Changes**. This replaces any old entries with a single `mcpbridge` entry. Then restart Claude Code.\n\n\n\n\nOllama errors\n\n- Confirm Ollama is running: `curl http://localhost:11434/api/tags`\n- Make sure `minimax-m2.5:cloud` is available in your Ollama setup\n\n\n\n\n\"Command timed out\"\n\n- The plugin may have been deactivated - click the toolbar/sidebar button again\n- Check the plugin widget for error messages\n\n\n\n\n🍎 macOS - \"App can't be opened\" security warning\n\nmacOS may block the installer on first launch since it isn't notarized. To allow it:\n\n1. Go to **System Settings → Privacy & Security**\n2. Scroll down and click **Open Anyway** next to MCPBridge\n3. Confirm in the dialog that appears\n\nAlternatively, right-click the `.pkg` and choose **Open** to bypass the warning directly.\n\n\n\n\n🍎 macOS - mcp-server or roblox-plugin folder not found\n\nOn first launch, MCPBridge automatically extracts these folders next to the `.pkg`. If auto-detection still fails, use the **Browse** button in the app to point to them manually. The folders will be located next to `MCPBridge.pkg` in the same directory.\n\n\n\n---\n\n## 📁 File Structure\n\n```\nMCPBridge/\n├── mcp-server/\n│ ├── index.js ← Unified MCP + HTTP bridge server (Roblox :7842, Blender :7843)\n│ └── package.json\n├── roblox-plugin/\n│ └── OllamaMCP.lua ← Roblox Studio plugin (auto-installed by MCPBridge app)\n├── blender-plugin/\n│ └── MCPBridge.py ← Blender addon (install manually via Edit → Preferences)\n├── MCPBridge.exe ← Windows installer (double-click to run)\n├── MCPBridge.pkg ← macOS installer (double-click to run)\n├── claude_mcp_config.json ← Example Claude Code config snippet\n├── server.json ← Official MCP Registry manifest\n├── skills.md ← Agent skill guide (also served as the mcpbridge://guide resource)\n├── start.sh ← Helper startup script\n├── LICENSE ← MIT license\n└── README.md\n```\n\n---\n\n## 📄 License\n\nMCPBridge is released under the [MIT License](LICENSE).\n",
"bytes": 15763,
"sha": "63a5cd2975d42abcac275af9eef938c2711837efcd8c718da2493cb8296d4139",
"repo_slug": "iamjrmh/mcpbridge",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_iamjrmh_mcpbridge_900ba97c/readme"
}
![\"Download](\"https://img.shields.io/badge/Download-MCPBridge.exe-0078d4?style=for-the-badge&logo=windows&logoColor=white\"){kind=icon}
\n![\"Download](\"https://img.shields.io/badge/Download-MCPBridge.pkg-000000?style=for-the-badge&logo=apple&logoColor=white\"){kind=icon}
\n![\"Recommended\"](\"https://img.shields.io/badge/Recommended-0078d4?logo=windows&logoColor=white\"){kind=icon}
![\"Recommended\"](\"https://img.shields.io/badge/Recommended-000000?logo=apple&logoColor=white\"){kind=icon}