BlenderMCP 参数配置全攻略：uvx blender-mcp 从启动到调通 9876 端口

BlenderMCP 参数配置全攻略uvx blender-mcp 从启动到调通 9876 端口【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp一句话让 AI 在 Blender 里搭出场景输入造一个低多边形地牢让龙守着一罐金子几秒后视口里就出现了巨龙和金堆。这是 BlenderMCP 做到的事——它用模型上下文协议MCP把 Blender 接到你的 AI 助手上服务进程由一条uvx blender-mcp命令拉起。全文按三个任务 一份避坑清单推进带你从零配置到连线成功。30 秒看懂两个部件怎么协作整个系统只有两个独立部件先记住这张图后面所有配置都围绕它展开Blender 插件addon.py装在 Blender 里本质上是一个 socket 服务器——在 9876 端口监听指令收到就执行再把结果回传MCP 服务器src/blender_mcp/server.py面向 AI 客户端的那一端负责把模型的请求转成 socket 指令发过去再取回执行结果。指令在链路里就是 JSON 报文比如建一个球体最终长这样{type: create_object, params: {type: SPHERE, name: Ball}}。链路方向是AI 客户端 → MCP 服务器 → TCP 9876 → Blender 插件 → 场景变化。客户端会自己拉起 MCP 服务器你不需要手动去敲uvx。任务一装好 uv把地基打平先看门槛三项都在的话可以直接进下一步依赖最低版本Blender3.0建议 4.x / 5.xPython3.10uv最新版uv 是新一代 Python 包管理器uvx是它附带的工具可以不先安装、直接运行某个包提供的命令——这正是uvx blender-mcp能一行起服务的原因。装 uv按系统选一条macOSbrew install uvWindowsPowerShellpowershell -c irm https://astral.sh/uv/install.ps1 | iex # 再把 %USERPROFILE%\.local\bin 加进 Path然后重开客户端Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh⚠️ 不要用pip install uv它不保证能生成uvx命令。任务二把主机和端口参数接进配置默认情况下 MCP 服务器会连本机的 9876 端口不用改任何东西。想自定义时靠这两个环境变量见 src/blender_mcp/server.py 的取值逻辑环境变量默认值作用BLENDER_HOSTlocalhostsocket 服务器所在主机BLENDER_PORT9876socket 服务器端口终端里直接设export BLENDER_HOSTlocalhost export BLENDER_PORT9876跑在容器或远程机器里时改的是BLENDER_HOSTDocker 里常用host.docker.internalWSL2 连 Windows 上的 Blender 则试127.0.0.1或宿主机 IP。也可以把同样的键值写进客户端配置的env段效果一致。Claude Desktop 配置打开 Claude 的claude_desktop_config.jsonSettings Developer Edit Config加上{ mcpServers: { blender: { command: uvx, args: [blender-mcp] } } }Cursor 配置macOS / Linux 写法与上面相同。Windows 上图形客户端往往找不到裸的uvx要用cmd包一层{ mcpServers: { blender: { command: cmd, args: [/c, uvx, blender-mcp] } } }改完配置后完全退出客户端再重启让它重新读取。⚠️ 同一时间只开一个客户端连 MCP 服务器。Cursor 和 Claude Desktop 一起开两个服务进程会互相抢 9876连接必然乱掉。任务三装插件、点连接、看锤子图标装插件四步从仓库下载 addon.pyBlender 里打开 编辑 偏好设置 插件点安装…选中刚下载的addon.py启用 Interface: Blender MCP。点连接打开 3D 视图侧边栏没显示就按N切到BlenderMCP标签页要用素材库的话把 Poly Haven 的复选框勾上点Connect to Claude。回到 AI 客户端对话界面里出现锤子图标就说明链路已经打通——Blender 的工具已被 AI 激活。跑起 uvx blender-mcp直接抄三条提示词在 Claude Desktop / Cursor 这类客户端里MCP 服务器由客户端自动拉起你只管发指令。想手动验证环境在终端执行uvx blender-mcp它不接受命令行参数全部可调项都走环境变量加前缀也能临时指定例如BLENDER_HOSThost.docker.internal uvx blender-mcp。连通后下面三条提示词可以直接复制粘贴Create a low poly dungeon with a dragon guarding gold低多边形地牢龙守金堆Beach scene with Poly Haven HDRIs, rocks, and vegetation用 Poly Haven 的 HDRI、岩石和植被搭海滩Generate a garden gnome with Hyper3D用 Hyper3D 生成一个花园地精⚠️ 两条使用注意Blender 用正常 GUI 会话跑不要用blender -b后台模式socket 和视口工具会失效execute_blender_code可以在 Blender 里执行任意 Python跑之前先保存工程。避坑清单现象 → 原因 → 解法1. AI 对 Blender 毫无反应原因插件端没点 Connect或防火墙拦了 9876 端口。 解法确认侧边栏里服务器处于已连接状态放行 9876 端口另外有条社区经验——连接后的第一条命令经常失败原样重试一次通常就好。2. 客户端报错找不到uvxspawn uvx ENOENT原因图形界面客户端不继承你终端的 PATH。 解法终端执行which uvxmacOS / Linux或where uvxWindows拿到绝对路径把它填进配置的command字段重启客户端。3. 复杂操作超时原因一步指令太重执行时间超出等待上限。 解法把大需求拆成多步小指令逐条发。4. 通信异常、指令时有时无原因插件端与服务端状态错位。 解法按顺序重启 Blender 插件 → 重启 MCP 客户端还不行就在客户端里删掉 blender 服务器再重新添加。进阶玩法素材库与任意代码Poly Haven在侧边栏勾上复选框后AI 可以直接替你下载 HDRI、纹理和 3D 模型进场景。Hyper3D Rodin文字生成 3D 资产的通道免费额度有每日上限需要稳定的话自备 API Key。自定义 PythonBlenderMCP 内置了execute_blender_code工具等于让 AI 直接在 Blender 里写脚本比如几行搞定一个金色金属材质import bpy mat bpy.data.materials.new(nameGoldMaterial) mat.use_nodes True mat.node_tree.nodes[Principled BSDF].inputs[Base Color].default_value (0.9, 0.7, 0.1, 1.0) mat.node_tree.nodes[Principled BSDF].inputs[Metallic].default_value 1.0各类 API 密钥建议存在 Blender 的 编辑 偏好设置 插件 Blender MCP 里重启后依然生效。收尾BlenderMCP 的参数配置就三件事装好 uv、把主机端口写进环境变量、在客户端登记uvx blender-mcp剩下的交给 AI。完整的集成方式清单在仓库的 README.md核心逻辑在 addon.py 与 src/blender_mcp/server.py。下一步很简单装好环境在 Blender 侧边栏点 Connect to Claude把第一条提示词发出去。【免费下载链接】blender-mcpCommunity plugin to control Blender 3D with any LLM of your choice项目地址: https://gitcode.com/GitHub_Trending/bl/blender-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考