尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案

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

发布时间：2026/11/3 5:06:01来源：尧图网络资讯中心
首页/资讯中心/文章详情
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），仅供参考
RELATED

相关推荐

茶颜悦色为什么选择画星人？ 一场品牌与插画创意的双向奔赴

茶颜悦色为什么选择画星人？ 一场品牌与插画创意的双向奔赴

核心摘要• 茶颜悦色与画星人的合作，本质上是一次品牌视觉需求与商业插画人才之间的连接。• 合作价值并非单纯完成插画作品，而是通过需求理解、人才匹配、创意产出、反馈迭代和内容落地，让插画能力进入真实品牌应用场景。 • 对品牌而言&…

📅 2026/9/27 23:56:08
彻底分清！脱醇葡萄酒、葡萄汁、无醇调配饮品的区别与选购攻略

彻底分清！脱醇葡萄酒、葡萄汁、无醇调配饮品的区别与选购攻略

彻底分清！脱醇葡萄酒、葡萄汁、无醇调配饮品的区别与选购攻略2026-09-04 10:09很多消费者选购无酒精饮品时，经常陷入选择困难：脱醇葡萄酒、无醇葡萄饮品、纯葡萄汁，三者外观相似，价格差距却很大，口感更是天…

📅 2026/9/28 5:25:40
从电竞到系统工程：解析移动电竞赛事背后的技术架构与实战准备

从电竞到系统工程：解析移动电竞赛事背后的技术架构与实战准备

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

📅 2026/9/27 12:48:52
MORE NEWS

更多资讯

📰

基于STM32与AD5542的微伏级脑电信号模拟发生系统设计

简介：面向脑机接口测试场景的高精度脑电信号模拟发生系统设计资料，适合医疗设备制造商、科研工作者及脑机接口开发团队参考。针对传统信号发生器系统复杂、体积庞大、精度不足且难以生成真实脑电模型的问题，资料围绕数模转换、同相比例放大与…
📰

WorkBuddy+微信+deepseek-v4-flash：打造每日AI日报自动推送系统

1. 为什么我要给 WorkBuddy 设一个“十点半闹钟”每天早上十点半，我的微信会准时收到一份 AI 日报。不是那种“今日天气晴，适合摸鱼”的废话推送，而是一份包含昨日任务回顾、今日待办优先级、行业动态摘要、以及我关注的几个技术方向最新进展…
📰

AgentScope：Java生产级AI Agent框架深度解析

1. 这不是玩具项目，是能扛住真实业务压力的AI Agent骨架AgentScope这个名字最近在Java技术圈里出现的频率越来越高，尤其当“AI Agent”不再只是论文里的概念，而是开始出现在电商订单履约、金融风控策略执行、客服工单自动分派这些真实业务场景…
📰

大模型实测避坑指南：数学推理、AI依赖、内存压缩与本地部署

1. 这不是新闻稿，是AI能力边界的实测切片：从OpenAI解题到千问本地部署的全链路拆解2026年9月22日这个日期本身没有特殊意义——它只是我整理手头三组真实测试数据时随手标下的时间戳。那天下午三点十七分，我关掉第7个终端窗口，把O…
📰

随机森林原理与实战：从民主决策到机器学习应用

1. 随机森林的本质：民主决策的机器学习模型随机森林(Random Forest)本质上是一个通过构建多棵决策树进行集成学习的算法。它的核心思想可以用一个生活场景来理解：假设你要决定周末去哪里玩，询问了10个朋友的意见。其中7人推荐去爬山&#xff…
📰

训练到部署：Model-Optimizer打通深度学习模型优化全流程

模型训练调参这件事，几乎每个做深度学习的人都被卡过脖子。半年前我接手一个检测模型的优化任务，既要把它训得更准，还要在推理阶段把体积和延迟压下来。先是花了一下午调SGD和Adam的学习率，又因为weight decay设置不对导致loss像过…
TODAY

今日更新

🆕

淘宝商品详情API开发实战与性能优化指南

1. 淘宝商品详情API核心功能解析淘宝开放平台的taobao.item.get接口是电商开发者最常调用的核心接口之一，它提供了获取单个商品完整信息的能力。这个接口的独特之处在于它能返回商品的基础信息、SKU数据、促销信息等全维度数据，且响应速度控制在200ms以内…
🆕

Unity Package Manager刷新错误排查与解决方案

1. Unity Package Manager刷新资源报错问题解析最近在Unity开发过程中，Package Manager提示"Error Refreshing Asset"的问题困扰了不少开发者。作为Unity项目依赖管理的核心组件，Package Manager一旦出现问题，轻则影响资源加载&…
🆕

Java record 规范构造器能否被反序列化或反射绕过

问题现象 record 类型通常靠规范构造器来把守不变式，比如禁止名字为空： public record User(String name) {public User {if (name == null || name
THIS WEEK

本周精选

📌

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代，基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而，与配合度高的人类不同，宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态，更无法控制光照环境。实际应用中，我们常…
📌

基于DRV8818与STM32的双极步进电机驱动方案实战解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …
📌

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …
THIS MONTH

本月热门

🔥

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代，基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而，与配合度高的人类不同，宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态，更无法控制光照环境。实际应用中，我们常…
🔥

基于DRV8818与STM32的双极步进电机驱动方案实战解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …
🔥

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

读完文章，想聊聊您的网站？

告诉我们您的行业与需求，资深顾问一对一梳理方案与报价，全程免费。

免费获取方案 400-888-6620
📞 💬