blender-mcp 是什么?

BlenderMCP 通过 Model Context Protocol(MCP)把 Blender 接到 Claude 等 AI 上,让 AI 直接控制 Blender 做提示词驱动的 3D 建模、场景搭建与编辑。它由两部分组成:装进 Blender 的插件(addon.py,在 Blender 里起一个 socket 服务器接收并执行命令)和一个实现 MCP 的 Python 服务器(连到该插件)。装好后你可以用自然语言让 AI 创建/修改/删除物体、调材质灯光、读取场景信息、甚至在 Blender 里跑任意 Python,还能拉 Poly Haven 资产、Sketchfab 模型,用 Hyper3D Rodin/Hunyuan3D 生成 3D 模型。Python,MIT,是最受欢迎的 MCP 集成之一。

⭐ 19,724 Stars 🍴 1,903 Forks Python MIT 作者: ahujasid
来源:README 顶部/Features/Components;GitHub lang=Python,license MIT 查看 GitHub 仓库 →

为什么值得关注

约 2.19 万星,是 MCP 生态里最火的集成之一。热度来自一个极有冲击力的演示场景:对 Claude 说一句『做个低多边形地牢,一条龙守着金币』,它就在 Blender 里把场景搭出来。把『AI 控制专业 3D 软件』做成开箱即用、还能接 Poly Haven/Sketchfab/Hyper3D 等资产与生成服务,对 3D 创作者和想玩 AI+3D 的人吸引力极大,也是 MCP 价值的标志性案例。

来源:GitHub 21,888 stars / 2,152 forks,created 2025-03-07;README Example Commands

核心功能

AI 双向控制 Blender

基于 socket 的双向通信把 Claude 连到 Blender:创建/修改/删除 3D 物体、应用与调整材质和颜色、获取当前场景的详细信息,让 AI 像操作员一样驱动 Blender。

来源:README Features(Two-way communication/Object manipulation/Material/Scene inspection)
在 Blender 里执行任意 Python

execute_blender_code 工具可让 AI 在 Blender 内运行任意 Python 代码,能力强但有风险(README 明确提示谨慎、用前务必保存工作)。

来源:README Features(Code execution)/Limitations & Security
资产库与 3D 生成集成

支持通过 Poly Haven API 拉 HDRI/纹理/模型、搜索下载 Sketchfab 模型,并能用 Hyper3D Rodin、Hunyuan3D 生成 3D 模型(Hyper3D 有免费试用 key 的每日额度)。

来源:README Current version/Hyper3D integration
视口截图理解场景

可获取 Blender 视口截图让 AI 更好地理解当前场景再操作;并支持把场景信息转成 three.js 草图等跨工具流转。

来源:README Current version(viewport screenshots)/Example Commands
多客户端 + 远程运行

可接 Claude Desktop、Cursor、VS Code 等 MCP 客户端;支持在远程主机上运行 Blender MCP;带匿名遥测(可关注)。

来源:README Installation(Claude/Cursor/VSCode)/Current version(remote host)

技术架构

结构很轻、职责清晰的两件套:① Blender 插件 addon.py——在 Blender 内部起一个 TCP socket 服务器,接收命令并在 Blender 的 Python 环境里执行(建模、改材质、跑代码、截图等);② MCP 服务器 src/blender_mcp/server.py——一个实现 MCP 协议的 Python 服务(用 uv 管理、uvx 运行),对上把 Blender 能力暴露为 MCP 工具给 Claude/Cursor 等客户端,对下经 socket 连到 Blender 插件。通信用简单的 JSON-over-TCP 协议(命令含 type+params,响应含 status+result/message)。资产/生成能力(Poly Haven、Sketchfab、Hyper3D、Hunyuan3D)作为工具集成进来。整体是『MCP 服务器 ↔ socket ↔ Blender 插件』的桥接架构,AI 通过 MCP 工具间接驱动一个本地运行的 Blender 实例。

来源:README Components/Technical Details;tree(addon.py、main.py、src/、pyproject.toml)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) MCP 协议 Blender(addon.py socket 服务器)Blender(addon… uv / uvx(运行 MCP server)uv / uvx(运行… Poly Haven / Sketchfab APIPoly Haven / S… Hyper3D Rodin / Hunyuan3D(3D 生成)Hyper3D Rodin… AI 双向控制 Blender 在 Blender 里执行任意 Python在 Blender 里执行任… 资产库与 3D 生成集成 视口截图理解场景 多客户端 + 远程运行 blender-mcp 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Python框架MCP(Model Context Protocol)+ Blender Addon
MCP 协议Blender(addon.py socket 服务器)uv / uvx(运行 MCP server)Poly Haven / Sketchfab APIHyper3D Rodin / Hunyuan3D(3D 生成)
本地:Blender 实例 + MCP server,经 JSON-over-TCP socket 通信;接 Claude Desktop/Cursor/VSCode;可远程主机运行
来源:README Components/Technical Details/Installation;pyproject.toml

快速上手

前提见 Prerequisites(含 Blender)。装两部分:① 把最新 addon.py 加进 Blender 作为插件并启动其 socket 服务器;② 在 Claude Desktop/Cursor/VS Code 里把 BlenderMCP 配成 MCP server(用 uvx 启动,注意 README 提醒别在终端手动跑 uvx)。连上后在 Blender 侧 Start Connection,再对 Claude 下自然语言指令,如『做个低多边形地牢,一条龙守着金币』『用 Poly Haven 的 HDRI 和模型做个海滩场景』『把这辆车变红色金属质感』。用 execute_blender_code 跑代码前务必先保存工程。
来源:README Installation/Usage/Example Commands

使用场景

适合:①想用自然语言快速搭 Blender 场景、做概念原型、布置灯光材质的 3D 创作者与爱好者;②想把 AI 接进 3D 工作流、或结合 Poly Haven/Sketchfab/Hyper3D 资产与生成的人;③想学 MCP 如何桥接专业桌面软件的开发者。不适合:需要精细、可控、生产级建模产出的专业制作(AI 生成质量与可控性有限,常需大量人工调整);以及不接受 AI 在 Blender 里执行任意 Python 代码风险的人。

来源:README Example Commands/Limitations,结合定位推断

优势与局限

优势

  • 标志性 MCP 案例:把『AI 控制专业 3D 软件』做成开箱即用,演示效果震撼、上手门槛低
  • 能力实在:双向控制 + 物体/材质/场景操作 + 任意 Python + 视口截图理解场景
  • 资产/生成生态好:接 Poly Haven、Sketchfab、Hyper3D Rodin、Hunyuan3D,少从零建模
  • 架构清晰轻量:MCP server ↔ socket ↔ Blender 插件,JSON-over-TCP,易理解可远程
  • 多客户端(Claude/Cursor/VSCode)、MIT、社区大,是 MCP 价值的代表作

局限

  • execute_blender_code 跑任意 Python 有安全风险,误操作可改坏工程,用前务必保存(README 明确警告)
  • AI 生成的 3D 质量与可控性有限,复杂/精细场景常需大量人工返工,时有 erratic 行为
  • 依赖本地 Blender 实例 + MCP 配置,连接偶发不稳定(README 列了多种 troubleshooting)
  • Hyper3D 等生成服务有免费额度限制,超出需自备 key、产生成本
  • 更新偏停滞(最近 push 2026-01),随 Blender/MCP/各资产 API 演进需维护
来源:README Limitations & Security/Troubleshooting;pushed_at

最新版本

当前版本 1.5.5(README 标注),近期加入了 Hunyuan3D 支持、视口截图、Sketchfab 搜索下载、Poly Haven 资产、Hyper3D Rodin 生成、远程主机运行与匿名遥测。仓库自 2025-03 起迭代,最近 push 在 2026-01-23,更新节奏近期偏缓。

来源:README Current version(1.5.5);pushed_at 2026-01-23

总结评价

BlenderMCP 是 MCP 生态里最有代表性的作品之一:它把『一句话让 AI 在 Blender 里搭出一整个场景』做成了开箱即用,架构也清爽(MCP server 经 socket 桥到 Blender 插件),还接好了 Poly Haven/Sketchfab/Hyper3D 等资产与生成服务,2.19 万星说明这个『AI+3D』的想象力有多打动人。要清醒它的边界:AI 生成的 3D 质量和可控性有限、复杂场景仍要大量人工返工、连接偶发不稳,且 execute_blender_code 跑任意代码有真实风险(用前务必保存)。对想玩 AI 辅助 3D、做概念原型或学 MCP 桥接桌面软件的人,它是必看的标杆项目;专业精细制作则只能当起步草搭,别指望一键成片。

来源:综合 README 定位/能力/限制、tree 架构、发布状态的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-22 23:56. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件