项目简介

这是一个为 Blockbench 3D 建模软件开发的插件，它在 Blockbench 内部实现并运行一个 Model Context Protocol (MCP) 服务器。安装并启用此插件后，外部的 LLM（大型语言模型）客户端或 AI 代理就可以通过标准的 MCP 协议与 Blockbench 进行通信，从而实现对建模过程的上下文感知和远程控制。

主要功能点

该插件将 Blockbench 的核心功能通过 MCP 接口暴露给 AI 代理：

• 资源 (Resources): 允许 AI 访问 Blockbench 项目中的数据，例如获取节点（模型元素）的信息、纹理列表或详情。
• 工具 (Tools): 使 AI 能够执行 Blockbench 中的操作，包括但不限于：
  • 创建、修改和移除模型元素（如方块）。
  • 添加和管理纹理及纹理组。
  • 执行 Blockbench 内置的菜单操作。
  • 填写和确认弹出的对话框。
  • 捕获当前视图或整个应用的截图。
  • 调整相机视角。
  • 从外部格式（如 GeoJSON）导入模型。
• Prompt 模板 (Prompts): 为 AI 提供预定义的交互模式或策略，例如指导 AI 如何按特定格式（如 Java 或 基岩版）创建模型。

通过这些功能，AI 代理可以理解 Blockbench 的当前状态，并执行复杂的建模任务。

安装步骤

1. 打开 Blockbench 桌面应用程序。
2. 点击菜单栏中的 '文件 (File)' > '插件 (Plugins)'。
3. 在插件窗口中，点击 '从URL加载插件 (Load Plugin from URL)' 按钮。
4. 在弹出的对话框中，粘贴以下插件的 URL 地址： 'https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js'
5. 点击加载，插件将被安装并启用。

服务器配置

Blockbench MCP 插件在安装后会自动启动一个 MCP 服务器。这个服务器运行在 Blockbench 应用程序内部。

为了让你的 MCP 客户端（例如：专门的 MCP 客户端应用程序、支持 MCP 的 LLM 桌面应用或 IDE 扩展）能够连接到 Blockbench 插件，你需要配置客户端指向这个服务器的地址。

默认情况下，服务器通过 HTTP Stream 协议运行在 'http://localhost:3000/mcp'。

你可以在 Blockbench 的 设置 (Settings) > 通用 (General) 中找到并修改 MCP 服务器端口 (MCP Server Port) 和 MCP 服务器端点 (MCP Server Endpoint) 这两个设置来更改默认地址。

配置 MCP 客户端时，通常需要提供以下信息：

• 服务器名称 (Server Name): 例如 'blockbench'。
• 连接方式 (Command/Args): 如果客户端使用 'mcp-remote' 工具连接，可能需要配置启动命令为 'npx mcp-remote'，参数为服务器的完整 URL 地址（如 'http://localhost:3000/mcp'）。如果客户端直接支持 HTTP Stream 或其他协议连接，则只需提供服务器 URL。

请参考你使用的 MCP 客户端的文档，根据 Blockbench 中的服务器地址进行相应的配置。

基本使用方法

插件安装成功后，Blockbench 就会运行一个 MCP 服务器。你可以通过在 Blockbench 侧边栏中找到并打开“MCP”面板来查看服务器的状态（是否连接、当前会话等）以及发现服务器暴露的工具和资源列表。

将你的 MCP 客户端配置并连接到 Blockbench MCP 服务器的地址。一旦连接建立，你的 AI 代理就可以开始通过客户端向 Blockbench 发送 MCP 请求，调用工具执行操作，读取资源获取模型数据等，实现通过 AI 控制 Blockbench 进行建模的目的。