Blender MCP 服务器

关键词

Blender自动化模型导入场景信息渲染

使用说明（Markdown 格式）

-- 项目简介 Blender MCP 服务器是一套将 Blender 功能暴露为 MCP 风格请求的后端服务，LLM 客户端可通过 JSON 结构的请求向服务器获取 Blender 的场景信息、对象信息、执行脚本、导入模型、渲染等能力，并得到结构化的 JSON 响应。

-- 主要功能点

  • 处理 MCP 风格请求与响应：通过简单的 JSON 请求中的 type 与 params，服务器执行对应的 Blender 操作并返回 JSON 响应。
  • 暴露 Blender 能力接口：包括获取场景信息、获取对象信息、执行脚本、导入模型、渲染输出、批量渲染、设置相机等能力，以及简单的 HDRI 添加等扩展操作。
  • 服务器端实现清晰、可运行：提供一个可独立启动的后端服务端组件，供 MCP 客户端对接使用。
  • 与 Blender 插件协同工作：依赖 Blender 环境与对应的插件/脚本，作为 MCP 服务端与 Blender 客户端的桥梁。

-- 安装步骤

  1. 确保系统中已安装 Node.js 环境（用于运行服务器端脚本）。
  2. 获取仓库中的 Blender MCP 服务端脚本：vf-blender/resources/mcp-server/server.js。
  3. 在合适的位置执行启动命令 node vf-blender/resources/mcp-server/server.js 启动服务，默认监听端口为 9876（如有需要可在代码中修改端口或通过环境变量覆盖）。
  4. 确保 Blender 及相关插件/脚本处于可访问状态，并且 Blender MCP 客户端能够通过网络或标准输入输出与服务器建立连接。

-- 服务器配置（MCP 客户端应以此信息启动并连接） { "server_name": "BlenderMCP", "command": "node", "args": ["vf-blender/resources/mcp-server/server.js"], "host": "0.0.0.0", "port": 9876, "notes": "默认端口为 9876；请确保 Blender 环境已就绪且服务器脚本可访问。" } 说明：

  • server_name：用于标识 MCP 服务器的名称，便于在多服务器环境中区分。
  • command：启动服务器所需的可执行程序，此处为 node。
  • args：启动命令的参数，指向实际的服务器脚本路径。
  • host、port：服务器对外暴露的地址与端口，LLM 客户端将通过该端口发起 MCP 请求。
  • notes：对客户端配置的简要说明与注意事项。

-- 基本使用方法

  • 启动服务器后，LLM 客户端发送一个包含 type 和 params 的 JSON 请求给服务器，例如请求场景信息、导入模型、执行脚本等，服务器返回 JSON 响应，包含执行结果或错误信息。
  • 常见请求类型示例（按实现的功能来理解，具体名称以代码实现为准）：获取场景信息、获取对象信息、执行 Blender 代码、导入模型、渲染输出、获取相机信息等。
  • 客户端收到响应后可将结果作为后续推理输入，或用于可视化、验证、调试等工作。

注意：实际使用时需确保 Blender 环境与服务器脚本配合良好，服务器端需要具备对 Blender 的访问能力以及相关的脚本/插件支持。

服务器信息

访问项目