Blockbench MCP Integration

Overview

• AI-assisted 3D model creation
• Texture application and manipulation
• Real-time model modifications
• Automated modeling operations

Prerequisites

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

Installation

Step 1: Install pnpm

npm install -g pnpm

Step 2: Clone and Build

git clone https://github.com/enfp-dev-studio/blockbench-mcp.git
cd blockbench-mcp
pnpm install
pnpm build

Step 3: Build the Blockbench Plugin

cd apps/mcp-plugin
pnpm build

Step 4: Install Plugin in Blockbench

1. Open Blockbench
2. Go to File → Plugins → Load Plugin from File
3. Select plugin from

   apps/mcp-plugin/dist/

4. Enable by checking "MCP Plugin"

Configuring MCP Client

Option A: Antigravity (Recommended for this workspace)

1. In Antigravity, go to Agent Session → MCP Servers → Manage MCP Servers
2. Add a new MCP server with the blockbench configuration

.mcp.json

e:\Hytale Modding\.mcp.json

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

C:/path/to/blockbench-mcp

Option B: Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json

~/Library/Application Support/Claude/claude_desktop_config.json

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

Usage

Starting the Connection

1. In Blockbench, open View → Panels
2. Find "MCP Plugin" panel
3. Click "Connect to MCP Server"
4. Plugin listens on port 9999

Capabilities

• Get model and project information
• Create, delete, and modify block models
• Apply textures and materials
• Execute custom modeling operations
• Track command history in real-time

Example Prompts for Claude

"Create a simple sword model with proper proportions"
"Add a crossguard to the existing sword model"
"Create a chest model with opening animation"
"Generate a pickaxe tool with different material variants"
"Show me the current model structure and elements"
"Create a character head with facial features"

Architecture

Claude AI ← MCP Protocol → MCP Server ← Socket.IO → Blockbench Plugin

• Socket.IO for real-time communication
• WebSocket on port 9999
• JSON-based commands with type/payload structure
• Event-driven architecture

Project Structure

blockbench-mcp/
├── apps/
│   ├── mcp-server/     # MCP server (Node.js)
│   └── mcp-plugin/     # Blockbench plugin
└── packages/
    └── shared/         # Shared TypeScript types

Troubleshooting