BlockbenchMCP 通过模型上下文协议（MCP）将 Blockbench 与 Claude AI 连接，使 Claude 能够直接与 Blockbench 交互并控制它。这种集成使得 AI 辅助的 3D 建模、纹理创建和块模型操作成为可能。

🚀 特色

• 双向通信：通过基于套接字的服务器将Claude AI连接到Blockbench
• 实时命令跟踪：通过专用历史面板监控所有MCP命令
• 模型操作：在Blockbench中创建、修改和删除块模型
• 实时反馈：获得Blockbench运营的即时响应
• 可扩展架构：易于添加新工具和功能

🏗️ 组成部分

该系统由两个主要组成部分组成：

1. Blockbench 插件（apps/mcp-plugin）：一个 Blockbench 插件，可在 Blockbench 内创建一个套接字服务器以接收和执行命令
2. MCP 服务器（apps/mcp-server）：实现模型上下文协议并连接 Blockbench 插件的Node.js服务器

📦 项目结构

️ 安装

先决条件

• Blockbench 4.0或更新版本
• Node.js 18.0及以上版本
• PNPM 包管理器

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