Blockbench MCP Plugin

什么是 Blockbench MCP Plugin？

Blockbench MCP 是一个开源插件，它在 Blockbench 桌面应用内运行一个 Model Context Protocol 服务器，让 Claude Code、VS Code、Cline 等 AI 智能体可以通过工具调用来构建低多边形 3D 模型、绘制贴图并制作动画。

该仓库由 jasonjgardner 维护，是社区项目，并非 Blockbench 官方的一部分。它包含两个服务器：一个是桌面插件，通过 HTTP 驱动正在运行的编辑器；另一个是无界面（headless）的 stdio 服务器，无需打开 Blockbench 即可编辑、校验、转换和渲染 .bbmodel 文件。

如何使用 Blockbench MCP Plugin？

前提条件：插件服务器需要 Blockbench 桌面版；headless 服务器需要安装 Node.js 和 npm。无需 API 密钥。

1. 在 Blockbench 中打开 File > Plugins，点击 Load Plugin from URL，粘贴 https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js。
2. 检查 Settings > General > MCP Server Port 和 MCP Server Endpoint。下面的示例使用默认地址 http://localhost:3000/bb-mcp。
3. 保持 Blockbench 处于打开状态，然后连接你的客户端。

使用 headless 的 Blockbench MCP 服务器时，请把 /path/to/models 替换为绝对路径。--root 为必填项，用于把文件访问限制在该目录内。

Claude Code

# Desktop plugin (HTTP)
claude mcp add blockbench --transport http http://localhost:3000/bb-mcp

# Headless (stdio)
claude mcp add bbmodel --transport stdio -- npx -y github:jasonjgardner/blockbench-mcp-plugin --root /path/to/models

Claude Desktop

Claude Desktop 通过 mcp-remote 连接 HTTP 插件。在 claude_desktop_config.json 中添加：

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

在 Windows 上，请使用 "command": "cmd"，并在 args 前面加上 "/c", "npx"。

VS Code

在 .vscode/mcp.json 中：

{
  "servers": {
    "blockbench": {
      "url": "http://localhost:3000/bb-mcp",
      "type": "http"
    }
  }
}

Codex

codex mcp add blockbench --url http://localhost:3000/bb-mcp

README 还提供了 Cline、Antigravity、OpenCode 和 Ollama（uvx ollmcp -u http://localhost:3000/bb-mcp）的配置说明。

Blockbench MCP Plugin 的主要功能

• MCP 服务器内置于 Blockbench 桌面应用，通过 Streamable HTTP 提供服务，端口和端点可配置
• 独立的 headless stdio 服务器处理 .bbmodel 文件，多个智能体可以并行工作，你也可以同时继续使用编辑器
• 提供立方体、网格、贴图、PBR 材质、UV、动画、相机、导出和项目设置等工具
• headless 模式可校验几何与动画，并导出 Bedrock .geo.json、Java 方块/物品模型以及模组实体类
• 默认仅限本机：监听 127.0.0.1/::1，拒绝非回环地址的 Origin 或 Host 请求头
• 其他 Blockbench 插件可以通过全局 MCP_QUEUE 注册自己的 MCP 工具
• 配套 Agent Skills 和带提示词示例的示例项目

Blockbench MCP Plugin 工具

桌面插件的工具按编辑器功能区分组：

• 建模： place_cube、modify_cube、place_mesh、extrude_mesh、subdivide_mesh、create_sphere、create_cylinder、loop_cut_mesh 和 knife_tool 用于创建和调整几何体。
• 大纲与元素： add_group、list_outline、duplicate_element、rename_element 和 remove_element 用于组织模型结构。
• 贴图与材质： create_texture、apply_texture、list_textures、create_pbr_material 和 import_texture_set 处理贴图和 PBR 通道。
• 相机与截图： set_camera_angle、capture_screenshot 和 capture_app_screenshot 让智能体查看自己的成果。
• 项目与导出： create_project、get_project_info、list_export_formats 和 export_model。
• 脚本： risky_eval 可在 Blockbench 中运行任意 JavaScript，可在设置中关闭。

headless 服务器使用 bbmodel_* 系列工具，例如 bbmodel_create、bbmodel_edit、bbmodel_validate、bbmodel_render 和 bbmodel_export_bedrock_geometry，另有 blockbench_launch 用于启动桌面应用。

Blockbench MCP Plugin 的使用场景

• 根据描述快速搭建游戏资产：“Create a low-poly treasure chest with a hinged lid and a 32x32 texture.”
• 制作 Minecraft 风格的生物和物品，然后导出 Bedrock 几何或 Java 方块/物品模型。
• 绑定骨骼并制作动画：“Add a walk cycle to this model and check that no limbs detach.”
• 用 headless 服务器批量检查一个文件夹中的 .bbmodel 文件，找出悬空部件或对称性问题。
• 让智能体截取视口画面，反复调整比例直到模型满意为止。
• 生成 PBR 贴图集，并为现有模型分配通道。

Blockbench MCP Plugin 与替代方案对比

如果你使用的是完整的 3D 软件而不是低多边形编辑器，Blender MCP 可以让智能体以类似方式控制 Blender。若在游戏引擎端工作，Unity MCP 和 Godot MCP 可将智能体连接到对应编辑器。对于 Minecraft 风格、类体素以及 Bedrock/Java 内容，Blockbench MCP 更合适，因为它的工具和导出器遵循 Blockbench 自身的格式。

Blockbench MCP Plugin 常见问题排查

• 客户端无法连接： Blockbench 必须处于运行状态并已加载插件，且 URL 必须与 Settings > General 中的端口和端点一致。默认路径是 /bb-mcp。
• 客户端位于 WSL2、虚拟机或另一台机器： 服务器默认只监听回环地址。将 MCP Server Host 设为 0.0.0.0 或 :: 并重新加载插件，但只能在可信网络中这样做，因为服务器没有任何认证。
• Windows 客户端无法启动 npx： 使用 "command": "cmd"，并在参数前加上 "/c", "npx"。
• headless 的修改没有显示在 Blockbench 中： Blockbench 不会重新加载磁盘上被修改的文件。请重新打开模型，并避免两边同时编辑同一个文件。
• headless 渲染失败： 渲染工具需要 Node 23.6 或更高版本以及 GPU；其他 headless 工具不依赖这些条件。