blockbench-mcp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Blockbench MCP Integration

Blockbench MCP 集成

Connect Blockbench to Claude AI via Model Context Protocol for AI-assisted 3D modeling.

通过Model Context Protocol（MCP）将Blockbench与Claude AI连接，实现AI辅助3D建模。

Overview

概述

BlockbenchMCP enables Claude to directly interact with and control Blockbench, allowing:

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

Repository: github.com/enfp-dev-studio/blockbench-mcp

BlockbenchMCP 允许Claude直接与Blockbench交互并对其进行控制，支持以下功能：

AI辅助3D模型创建
纹理的应用与编辑
实时模型修改
自动化建模操作

代码仓库: github.com/enfp-dev-studio/blockbench-mcp

Prerequisites

前置要求

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

Blockbench 4.0 或更高版本
Node.js 18.0 或更高版本
pnpm 包管理器

Installation

安装步骤

Step 1: Install pnpm

步骤1：安装pnpm

bash

npm install -g pnpm

bash

npm install -g pnpm

Step 2: Clone and Build

步骤2：克隆并构建项目

bash

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

bash

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

Step 3: Build the Blockbench Plugin

步骤3：构建Blockbench插件

bash

cd apps/mcp-plugin
pnpm build

bash

cd apps/mcp-plugin
pnpm build

Step 4: Install Plugin in Blockbench

步骤4：在Blockbench中安装插件

Open Blockbench
Go to File → Plugins → Load Plugin from File
Select plugin from
```
apps/mcp-plugin/dist/
```
Enable by checking "MCP Plugin"

打开Blockbench
进入 文件 → 插件 → 从文件加载插件
选择
```
apps/mcp-plugin/dist/
```
目录下的插件文件
勾选“MCP Plugin”启用插件

Configuring MCP Client

配置MCP客户端

Option A: Antigravity (Recommended for this workspace)

选项A：Antigravity（此工作区推荐）

Antigravity has native MCP support! Configure it directly in your workspace:

Method 1: Via UI

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

Method 2: Via Config File

Create

.mcp.json

in your workspace root (

e:\Hytale Modding\.mcp.json

json

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

Replace

C:/path/to/blockbench-mcp

with your actual installation path.

After configuration, Claude in Antigravity will have direct access to Blockbench tools!

Antigravity原生支持MCP！可直接在工作区中配置：

方法1：通过UI界面

在Antigravity中，进入 Agent Session → MCP Servers → 管理MCP服务器
添加一个新的MCP服务器并配置Blockbench相关参数

方法2：通过配置文件

在工作区根目录创建

.mcp.json

文件（示例路径：

e:\Hytale Modding\.mcp.json

）：

json

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

将

C:/path/to/blockbench-mcp

替换为你的实际安装路径。

配置完成后，Antigravity中的Claude将可直接访问Blockbench工具！

Option B: Claude Desktop

选项B：Claude Desktop

Add to Claude Desktop config:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

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

json

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

添加配置到Claude Desktop的配置文件中：

Windows系统:

%APPDATA%\Claude\claude_desktop_config.json

macOS系统:

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

json

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

Usage

使用方法

Starting the Connection

启动连接

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

在Blockbench中，打开 视图 → 面板
找到“MCP Plugin”面板
点击 “连接到MCP服务器”
插件将在 9999端口 监听连接

Capabilities

功能特性

Once connected, Claude can:

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

连接成功后，Claude可实现以下操作：

获取模型与项目信息
创建、删除及修改方块模型
应用纹理与材质
执行自定义建模操作
实时追踪命令历史

Example Prompts for Claude

给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

Claude AI ← MCP协议 → MCP服务器 ← Socket.IO → Blockbench插件

采用 Socket.IO 实现实时通信
在 9999端口 基于WebSocket通信
采用 JSON格式 的命令结构，包含类型与负载
基于 事件驱动 的架构设计

Project Structure

项目结构

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

blockbench-mcp/
├── apps/
│   ├── mcp-server/     # MCP服务器（Node.js）
│   └── mcp-plugin/     # Blockbench插件
└── packages/
    └── shared/         # 共享TypeScript类型定义

Troubleshooting

问题排查

Issue	Solution
Connection issues	Ensure Blockbench plugin running, MCP server configured
Port conflicts	Port 9999 in use - close conflicting apps
Plugin not loading	Verify build successful, Blockbench version compatible
Command timeouts	Simplify requests, break into smaller steps
No tools in Antigravity	Check .mcp.json path is correct, restart Antigravity
No hammer icon in Claude Desktop	Restart Claude Desktop after config change

问题	解决方案
连接问题	确保Blockbench插件已运行，MCP服务器配置正确
端口冲突	9999端口被占用 - 关闭占用该端口的应用
插件无法加载	验证构建是否成功，Blockbench版本是否兼容
命令超时	简化请求内容，拆分为更小的步骤
Antigravity中无可用工具	检查.mcp.json路径是否正确，重启Antigravity
Claude Desktop中无锤子图标	修改配置后重启Claude Desktop