Blockbench MCP

社区

为 Blockbench 添加 MCP 服务器，让 AI 客户端连接本地建模环境

分类: 开发工具第 176 / 438
Stars: ★ 596 非常热门
传输方式: Streamable HTTP
运行环境: Node.js
凭据: 无需凭据
许可证: GPL-3.0
最近提交: 7 天前

56FMRS · C

Blockbench MCP 以插件形式为 Blockbench 提供本地 MCP 服务器，README 给出了 VS Code、Claude Desktop、Claude Code、Cline、Ollama、OpenCode、Antigravity 等客户端配置示例，许可证为 GPL-3.0。它适合希望在本地建模环境中接入 AI 客户端的用户，但 README 未列出具体工具清单，且不属于官方产品。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

10/20

维护活跃度

11/20

文档质量

12/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: 仓库被描述为仅含插件发布产物（README 指导从 jasonjgardner.github.io 加载 mcp.js），提供的材料中没有任何源代码、工具清单、CI 工作流或提交的测试，因此无法验证 MCP 初始化与工具列表握手能否成功，也无法核对声明工具与实际行为是否一致。按静态校准规则，缺少可验证执行证据使可靠性不得高于 12；此处仅有可用性描述与 438 star 的发现信号（不加分），错误处理、依赖可控性和边界情况均属未知，故取 9 分。
安全与权限 10/20: 未发现红线行为：无凭据窃取、无隐藏外传、安装示例中不含真实 token 或密钥；服务仅监听本地 http://localhost:3000/bb-mcp，权限面相对受限。但它是无鉴权的本地 HTTP 端点，任何本机进程均可连接并驱动 Blockbench 的模型编辑工具，且插件以远程 URL 形式动态加载（jasonjgardner.github.io），存在供应链与更新可信性问题；仓库内没有可见的权限声明、危险操作确认机制或数据流披露。风险可见但缓解不完整，未达红线，给 10 分。
维护活跃度 11/20: GPL-3.0 许可明确，未归档，开放 issue 仅 1 个，说明项目相对活跃且有明确所有权（jasonjgardner）。但所提供的材料中没有 release 记录、提交历史、依赖更新策略或安全响应渠道说明，治理与版本路径存在空缺，且 MCP 服务器本身即为仓库根目录形态、无清单缓存可供核对。按“活跃但治理/版本化有缺口”的锚点取 11 分。
文档质量 12/20: 文档覆盖面较广：包含插件安装 URL、MCP Server 端口/端点设置，以及 General、VS Code、Claude Desktop（macOS/Linux 与 Windows 双版本）、Claude Code、Antigravity、Cline、Ollama、OpenCode 等多种客户端配置示例，并给出示例项目与 Skills 链接。但缺少工具参数说明、权限与安全边界、成本/限制、故障排查章节，也未披露动态远程加载插件的安全含义；部分客户端配置（如 OpenCode、Antigravity）以截图代替文本，存在隐含假设。属“可用但有隐藏假设与排障缺口”，取 12 分。
安装易用性 14/20: 安装路径清晰：先在 Blockbench 桌面版通过 File > Plugins > Load Plugin from URL 载入给定 URL，再在设置中配置端口/端点，然后按主流客户端模板填写配置即可。步骤少、无需自备运行时之外的构建，兼容多平台并给出 Windows 专用命令。但该流程必须依赖桌面版 Blockbench（非 headless），且配置正确性无法在静态审查中验证，无 CI/测试佐证；按静态校准上限 15 且无执行证据，取 14 分。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

适合谁

使用桌面版 Blockbench 的 3D 建模人员
希望在本地建模环境中接入 MCP 客户端的开发者
需要为 Blockbench 工作流引入 AI 辅助的用户

不适合谁

无法运行桌面版 Blockbench 或无法加载插件的用户
不能访问本地 HTTP 端口的客户端
需要官方支持或托管服务的用户

所需权限

需要在 Blockbench 中加载并运行第三方插件
需要在本地开放 MCP 服务器端口（默认 3000）
AI 客户端需要访问 http://localhost:3000/bb-mcp

风险与副作用

插件由第三方维护，非 Blockbench 官方出品
本地 MCP 端点若未加限制，可能被本机其他程序访问
端口与端点配置错误会导致连接失败
通过 URL 加载插件意味着依赖远程脚本分发

安装接入

准备工作

运行环境：Node.js

打开桌面版 Blockbench，进入文件 > 插件，点击“从 URL 加载插件”，粘贴 https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js。
在 Blockbench 中打开设置 > 通用，配置 MCP Server Port 与 MCP Server Endpoint（默认 :3000/bb-mcp）。
在 AI 客户端中配置 MCP 服务器，例如通用方式：npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project。
Claude Desktop 可使用 mcp-remote 转发：npx -y mcp-remote http://localhost:3000/bb-mcp（Windows 下通过 cmd /c 调用）。
VS Code 可写入 .vscode/mcp.json，Cline 可写入 cline_mcp_settings.json。

claude_desktop_config.json

{
  "mcpServers": {
    "blockbench": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "blockbench": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/bb-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add blockbench -- npx -y mcp-remote http://localhost:3000/bb-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Blockbench 设置（Settings > General > MCP Server Port / Endpoint）确认服务器运行在默认 :3000/bb-mcp，然后在 MCP 客户端的工具列表中应出现 blockbench 服务器暴露的工具。

常见排障

确认使用桌面版 Blockbench 并已成功加载插件
检查设置 > 通用中的 MCP Server Port/Endpoint 是否为默认 :3000/bb-mcp
确认客户端连接地址为 http://localhost:3000/bb-mcp
Claude Desktop 在 Windows 需使用 cmd /c 包裹 npx
确认端口 3000 未被其他程序占用

试试这样问

连接成功后，可以直接对 AI 助手这样说：

连接后列出 Blockbench 当前可用的 MCP 工具
通过 MCP 查看当前 Blockbench 项目中的模型信息
按照示例项目中的提示词对当前模型执行一次操作

使用场景

让 AI 客户端通过 MCP 连接本地 Blockbench 会话

在 Blockbench 建模流程中调用 AI 助手辅助操作

通过 Agent Skills 编排工具调用

支持客户端

VS Code

Claude Desktop

Claude Code

Cline

Ollama部分支持

OpenCode部分支持

Antigravity

依据项目文档列出，未经本站实测。

详细介绍

Blockbench MCP 是一个 Blockbench 插件，在 Blockbench 内启动一个 MCP 服务器，使支持 MCP 的 AI 客户端可以通过 HTTP 连接到本地的 Blockbench 实例。插件需从 URL 加载安装，服务器端口与端点可在 Blockbench 的设置 > 通用中配置，默认值为 :3000/bb-mcp。README 还提到可使用 Agent Skills 来编排工具调用，并指向示例项目。