Skip to content
Back to search

blockbench-mcp-plugin

Adds MCP server to Blockbench

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jasonjgardner--blockbench-mcp-plugin/badge.svg)](/listings/jasonjgardner--blockbench-mcp-plugin)

HTML

<a href="/listings/jasonjgardner--blockbench-mcp-plugin"><img src="/api/listings/jasonjgardner--blockbench-mcp-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The examples below configure the desktop plugin over **HTTP** and the headless server over **stdio**. You can use either server or both. HTTP requires Blockbench running with the plugin installed; stdio requires Node.js with npm and starts its own server process.

For headless examples, replace `/path/to/models` with an absolute path to your model directory (for example, `C:/Users/you/models` on Windows). `--root` is required and limits file access to that directory.

> On Windows, clients that cannot launch `npx` directly should use `"command": "cmd"` and prepend `"/c", "npx"` to `args`, as shown for Claude Desktop.

<details> <summary>General</summary>

# Desktop plugin (HTTP)
npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project

# Headless (stdio)
npx mcp-add --name bbmodel --type stdio --command "npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models" --scope project

</details>

<details> <summary>VS Code</summary>

**`.vscode/mcp.json`**

{
  "servers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "http"
    },
    "bbmodel": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "github:jasonjgardner/blockbench-mcp-plugin",
        "--root",
        "${input:rootDir}"
      ]
    }
  },
  "inputs": [
    {
      "id": "rootDir",
      "type": "promptString",
      "description": "Root directory for headless Blockbench models",
      "default": "${workspaceFolder}/models"
    }
  ]
}

</details>

<details> <summary>Claude Desktop</summary>

**`claude_desktop_config.json`** (macOS/Linux)

{
  "mcpServers": {
    "blockbench": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    },
    "bbmodel": {
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
    }
  }
}

**`claude_desktop_config.json`** (Windows)

{
  "mcpServers": {
    "blockbench": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    },
    "bbmodel": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "C:/Users/you/models"]
    }
  }
}

</details>

<details> <summary>Claude Code</summary>

# Desktop plugin (HTTP)
claude mcp add blockbench --transport http http://localhost:3000/bb-mcp

# Headless (stdio)
claude mcp add bbmodel --transport stdio -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models

</details>

<details> <summary>Codex</summary>

codex plugin marketplace add jasonjgardner/blockbench-mcp-project --ref codex
codex plugin add blockbench-mcp@blockbench-mcp-project

Or register the servers directly:

# Desktop plugin (HTTP)
codex mcp add blockbench --url http://localhost:3000/bb-mcp

# Headless (stdio)
codex mcp add bbmodel -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models

</details>

<details> <summary><a href="https://antigravity.google/docs/mcp#connecting-custom-mcp-servers">Antigravity</a></summary>

{
  "mcpServers": {
    "blockbench": {
      "serverUrl": "http://localhost:3000/bb-mcp"
    },
    "bbmodel": {
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
    }
  }
}

</details>

<details> <summary>Cline</summary>

**`cline_mcp_settings.json`**

{
  "mcpServers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "streamableHttp",
      "disabled": false,
      "autoApprove": []
    },
    "bbmodel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

</details>

<details> <summary>Ollama</summary>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 284 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Blockbench MCP
  2. <img width="2554" height="1390" alt="Blockbench MCP Plugin screenshot" src="https://github.com/user-attachments/assets/fc897c9c-e4be-403d-803b-e981047a4575" style="aspect-ratio:2554/1390;width:100%;height:auto;" />
  3. <details>
  4. <summary>Demo Reel</summary>
  5. https://github.com/user-attachments/assets/c67d0dd8-ee50-40ba-b308-a84a21772901
  6. > All scenes, models, and textures created through Blockbench MCP plugin using agent skills. (Rendered in Blender)
  7. </details>
  8. [![skills.sh](https://skills.sh/b/jasonjgardner/blockbench-mcp-project)](https://skills.sh/jasonjgardner/blockbench-mcp-project)
  9. ## Plugin Installation
  10. Open the desktop version of Blockbench, go to File > Plugins and click the "Load Plugin from URL" and paste in this URL:
  11. **[https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js](https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js)**
  12. ## Model Context Protocol Servers
  13. This repository contains two MCP server options.
  14. ### Headless `.bbmodel` (stdio)
  15. A separate stdio MCP server edits, validates, converts and renders `.bbmodel` files directly, without Blockbench running. Each agent can start its own process, so several can work in parallel while you keep using the editor. Run it straight from GitHub:
  16. ```bash
  17. npx -y github:jasonjgardner/blockbench-mcp-plugin --root ./models
  18. ```
  19. See [headless/README.md](headless/README.md) for client configuration, the tool list and limits.
  20. ### Blockbench Desktop Plugin (HTTP)
  21. Configure the MCP server under Blockbench settings: **Settings** > **General** > **MCP Server Port** and **MCP Server Endpoint**.
  22. > The following installation settings examples use the default values of `:3000/bb-mcp`
  23. ## Installation
  24. The examples below configure the desktop plugin over **HTTP** and the headless server over **stdio**. You can use either server or both. HTTP requires Blockbench running with the plugin installed; stdio requires Node.js with npm and starts its own server process.
  25. For headless examples, replace `/path/to/models` with an absolute path to your model directory (for example, `C:/Users/you/models` on Windows). `--root` is required and limits file access to that directory.
  26. > On Windows, clients that cannot launch `npx` directly should use `"command": "cmd"` and prepend `"/c", "npx"` to `args`, as shown for Claude Desktop.
  27. <details>
  28. <summary>General</summary>
  29. ```bash
  30. # Desktop plugin (HTTP)
  31. npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project
  32. # Headless (stdio)
  33. npx mcp-add --name bbmodel --type stdio --command "npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models" --scope project
  34. ```
  35. </details>
  36. <details>
  37. <summary>VS Code</summary>
  38. **`.vscode/mcp.json`**
  39. ```json
  40. {
  41. "servers": {
  42. "blockbench": {
  43. "url": "http://localhost:3000/bb-mcp",
  44. "type": "http"
  45. },
  46. "bbmodel": {
  47. "type": "stdio",
  48. "command": "npx",
  49. "args": [
  50. "-y",
  51. "github:jasonjgardner/blockbench-mcp-plugin",
  52. "--root",
  53. "${input:rootDir}"
  54. ]
  55. }
  56. },
  57. "inputs": [
  58. {
  59. "id": "rootDir",
  60. "type": "promptString",
  61. "description": "Root directory for headless Blockbench models",
  62. "default": "${workspaceFolder}/models"
  63. }
  64. ]
  65. }
  66. ```
  67. </details>
  68. <details>
  69. <summary>Claude Desktop</summary>
  70. **`claude_desktop_config.json`** (macOS/Linux)
  71. ```json
  72. {
  73. "mcpServers": {
  74. "blockbench": {
  75. "command": "npx",
  76. "args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
  77. },
  78. "bbmodel": {
  79. "command": "npx",
  80. "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
  81. }
  82. }
  83. }
  84. ```
  85. **`claude_desktop_config.json`** (Windows)
  86. ```json
  87. {
  88. "mcpServers": {
  89. "blockbench": {
  90. "command": "cmd",
  91. "args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
  92. },
  93. "bbmodel": {
  94. "command": "cmd",
  95. "args": ["/c", "npx", "-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "C:/Users/you/models"]
  96. }
  97. }
  98. }
  99. ```
  100. </details>
  101. <details>
  102. <summary>Claude Code</summary>
  103. ```bash
  104. # Desktop plugin (HTTP)
  105. claude mcp add blockbench --transport http http://localhost:3000/bb-mcp
  106. # Headless (stdio)
  107. claude mcp add bbmodel --transport stdio -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models
  108. ```
  109. </details>
  110. <details>
  111. <summary>Codex</summary>
  112. ```bash
  113. codex plugin marketplace add jasonjgardner/blockbench-mcp-project --ref codex
  114. codex plugin add blockbench-mcp@blockbench-mcp-project
  115. ```
  116. Or register the servers directly:
  117. ```bash
  118. # Desktop plugin (HTTP)
  119. codex mcp add blockbench --url http://localhost:3000/bb-mcp
  120. # Headless (stdio)
  121. codex mcp add bbmodel -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models
  122. ```
  123. </details>
  124. <details>
  125. <summary><a href="https://antigravity.google/docs/mcp#connecting-custom-mcp-servers">Antigravity</a></summary>
  126. ```json
  127. {
  128. "mcpServers": {
  129. "blockbench": {
  130. "serverUrl": "http://localhost:3000/bb-mcp"
  131. },
  132. "bbmodel": {
  133. "command": "npx",
  134. "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"]
  135. }
  136. }
  137. }
  138. ```
  139. </details>
  140. <details>
  141. <summary>Cline</summary>
  142. <img width="674" height="486" alt="Connecting to Blockbench MCP plugin through Cline" src="https://github.com/user-attachments/assets/f27f2304-dd56-4c60-b159-86fbd5af65ee" />
  143. **`cline_mcp_settings.json`**
  144. ```json
  145. {
  146. "mcpServers": {
  147. "blockbench": {
  148. "url": "http://localhost:3000/bb-mcp",
  149. "type": "streamableHttp",
  150. "disabled": false,
  151. "autoApprove": []
  152. },
  153. "bbmodel": {
  154. "type": "stdio",
  155. "command": "npx",
  156. "args": ["-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"],
  157. "disabled": false,
  158. "autoApprove": []
  159. }
  160. }
  161. }
  162. ```
  163. </details>
  164. <details>
  165. <summary>Ollama</summary>
  166. ```bash
  167. # Desktop plugin (HTTP)
  168. uvx ollmcp -u http://localhost:3000/bb-mcp
  169. # Headless (stdio): register, then start the client
  170. uvx ollmcp mcp add bbmodel -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models
  171. uvx ollmcp
  172. ```
  173. Recommended: [jonigl/mcp-client-for-ollama](https://github.com/jonigl/mcp-client-for-ollama)
  174. </details>
  175. <details>
  176. <summary>OpenCode</summary>
  177. ```bash
  178. opencode mcp add
  179. ```
  180. Choose a remote server for the desktop HTTP URL, or a local server for the headless command. You can also configure both in **`opencode.json`**:
  181. ```json
  182. {
  183. "$schema": "https://opencode.ai/config.json",
  184. "mcp": {
  185. "blockbench": {
  186. "type": "remote",
  187. "url": "http://localhost:3000/bb-mcp",
  188. "enabled": true
  189. },
  190. "bbmodel": {
  191. "type": "local",
  192. "command": ["npx", "-y", "github:jasonjgardner/blockbench-mcp-plugin", "--root", "/path/to/models"],
  193. "enabled": true
  194. }
  195. }
  196. }
  197. ```
  198. See the [OpenCode MCP configuration reference](https://opencode.ai/docs/mcp-servers/) for local and remote server options.
  199. <img width="504" height="300" alt="Connecting to Blockbench MCP plugin through OpenCode." src="https://github.com/user-attachments/assets/238971fc-0048-4b8d-95dd-6681604bbe90" />
  200. </details>
  201. ## Usage
  202. [See sample project](https://github.com/jasonjgardner/blockbench-mcp-project) for prompt examples.
  203. ### [Skills](https://skills.sh/jasonjgardner/blockbench-mcp-project)
  204. Use Agent Skills to orchestrate tool usage.
  205. ## Extending from another plugin
  206. Other Blockbench plugins can register their own MCP tools through a global `MCP_QUEUE`, without bundling or importing this plugin. See [docs/plugin.md](docs/plugin.md) for the API and an example.
  207. > [!NOTE]
  208. > Plugins in the official Blockbench plugin repository are not allowed to use AI features, so a plugin that registers MCP tools has to be distributed some other way.
  209. ## Plugin Development
  210. See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed instructions on setting up the development environment and how to add new tools, resources, and prompts.
  211. ## Security
  212. The desktop plugin's HTTP server listens on this computer only (`127.0.0.1` and `::1`) by default, so `http://localhost:3000/bb-mcp` works whether a client resolves `localhost` to IPv4 or IPv6. Requests with a non-loopback `Origin` or `Host` header get `403 Forbidden`, which keeps web pages, including DNS rebinding attacks, from driving Blockbench through your browser.
  213. To accept connections from other computers (for example a client inside WSL2 without mirrored networking, a VM, or another machine), set **Settings** > **General** > **MCP Server Host** to `0.0.0.0` or `::` and reload the plugin. In that mode the `Host` header is no longer checked, since other computers reach the server by its address, but requests with a non-loopback `Origin` header are still refused. The server has no authentication: anyone who can reach the port can call every tool, including `risky_eval`. Only do this on a trusted network and keep your firewall rules restrictive.
  214. `risky_eval` runs any JavaScript a client sends. To turn it off, clear **Settings** > **General** > **Enable risky_eval**: connected clients stop seeing the tool and its calls are refused.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.