Blockbench MCP

Demo Reel

https://github.com/user-attachments/assets/c67d0dd8-ee50-40ba-b308-a84a21772901

All scenes, models, and textures created through Blockbench MCP plugin using agent skills. (Rendered in Blender)

Plugin Installation

Open the desktop version of Blockbench, go to File > Plugins and click the "Load Plugin from URL" and paste in this URL:

https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js

Model Context Protocol Servers

This repository contains two MCP server options.

Headless .bbmodel (stdio)

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:

npx -y github:jasonjgardner/blockbench-mcp-plugin --root ./models

See headless/README.md for client configuration, the tool list and limits.

Blockbench Desktop Plugin (HTTP)

Configure the MCP server under Blockbench settings: Settings > General > MCP Server Port and MCP Server Endpoint.

The following installation settings examples use the default values of :3000/bb-mcp

Installation

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.

General

# 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

VS Code

.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"
    }
  ]
}

Claude Desktop

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"]
    }
  }
}