BlockbenchMCP - Blockbench Model Context Protocol Integration

BlockbenchMCP connects Blockbench to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blockbench. This integration enables AI-assisted 3D modeling, texture creation, and block model manipulation.

🚀 Features

• Two-way communication: Connect Claude AI to Blockbench through a socket-based server
• Real-time command tracking: Monitor all MCP commands with a dedicated history panel
• Model manipulation: Create, modify, and delete block models in Blockbench
• Live feedback: Get instant responses from Blockbench operations
• Extensible architecture: Easy to add new tools and capabilities

🏗️ Components

The system consists of two main components:

1. Blockbench Plugin (apps/mcp-plugin): A Blockbench plugin that creates a socket server within Blockbench to receive and execute commands
2. MCP Server (apps/mcp-server): A Node.js server that implements the Model Context Protocol and connects to the Blockbench plugin

📦 Project Structure

blockbench-mcp/
├── apps/
│   ├── mcp-server/      # MCP server implementation
│   └── mcp-plugin/      # Blockbench plugin
└── packages/
    └── shared/          # Shared TypeScript types

�️ Installation

Prerequisites

• Blockbench 4.0 or newer
• Node.js 18.0 or newer
• pnpm package manager

Install pnpm if you haven’t already:

npm install -g pnpm

1. Clone and Setup

git clone https://github.com/enfpdev/blockbench-mcp.git
cd blockbench-mcp
pnpm install

2. Build the Project

pnpm build

3. Install the Blockbench Plugin

1. Build the plugin: cd apps/mcp-plugin && pnpm build
2. Open Blockbench
3. Go to File > Plugins > Load Plugin from File
4. Select the built plugin file from apps/mcp-plugin/dist/
5. Enable the plugin by checking the box next to “MCP Plugin”

4. Claude Desktop Integration

Add the following to your Claude Desktop configuration file:

Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "blockbench": {
      "command": "node",
      "args": [
        "/path/to/blockbench-mcp/apps/mcp-server/dist/index.js"
      ]
    }
  }
}

🎮 Usage

Starting the Connection

1. In Blockbench, open the plugin panel (if not visible, go to View > Panels)
2. Find the “MCP Plugin” panel
3. Click “Connect to MCP Server”
4. The plugin will start listening on port 9999

Using with Claude

Once the configuration is set in Claude Desktop and the plugin is running in Blockbench, you’ll see a hammer icon with tools for Blockbench MCP.

Capabilities

• Get model and project information
• Create, delete, and modify block models
• Apply textures and materials
• Execute custom modeling operations