mcp-for-blender

用嘴指挥 Blender 建模，说句话就改场景

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 3072 🐛 待处理 53 👀 关注 212

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 33769

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

mcp-for-blender 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队ahujasid

官网地址https://www.mcp-for-blender.com

GitHubhttps://github.com/ahujasid/mcp-for-blender

定价模式🏷️定价信息待确认

价格说明定价信息待确认

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言Python

技术栈/模型3d-modeling,ai,blender,blender-addon,blender-mcp,claude,generative-ai,llm,mcp,model-context-protocol,python

GitHub 星标★ 33769

上线时间2025-03-07 00:00:00

代码更新2026-11-04

仓库体积2.1 MB

本站数据更新2026-11-10

维护状态活跃

收录时间2026-09-26

浏览次数2

项目介绍

mcp-for-blender 是一个 Blender 社区插件，通过 Model Context Protocol（MCP）把 Blender 3D 软件与大语言模型连接起来。它解决的核心问题是：让用户用自然语言指令驱动 Blender 完成建模、场景搭建和对象操作，而不用手写 Python 脚本或逐项点击菜单。插件在 Blender 内启动一个 MCP 服务端，把场景查询、对象创建、材质修改、变换操作等能力暴露成工具接口，任何支持 MCP 的 LLM 客户端（如 Claude 等）都能调用。用户只需描述需求，模型即可读取当前场景状态并执行对应操作，实现对话式 3D 创作。项目用 Python 编写，以 Blender 插件形式安装，兼容任意 LLM，不绑定单一厂商，适合希望用 AI 加速 3D 工作流的建模师、开发者和创意工作者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-26 · 当前星标 ★ 33769

技术标签

3d-modeling ai blender blender-addon claude

使用教程

难度：进阶约 10 分钟部署方式：本地安装 7 步

环境要求

已安装 Blender 3D（插件需在 Blender 内启用）
已安装 uv，或改用 pipx 安装
一个支持 MCP 的 LLM 客户端（如 Claude）
可选：Docker，用于以容器方式运行 MCP 服务端

安装与启动步骤

1安装 uv

README 的 Quickstart 第一步是安装 uv，但节选中具体安装命令被截断，请按 uv 官方说明安装后再继续。
2安装 MCP 服务端

锁定环境无法使用 uvx 时，用 pipx 安装 mcp-for-blender，并确保 PATH 生效后重启终端或客户端。
```
pipx install mcp-for-blender
pipx ensurepath
```
3配置 MCP 客户端

pipx 方式把 which 得到的 mcp-for-blender 绝对路径填到客户端 command，并省略 args。
```
which mcp-for-blender
```
4Docker 方式运行

不想本地安装时，从仓库根目录构建镜像，容器只跑 MCP 服务端，Blender 仍在本机运行。
```
docker build -t mcp-for-blender .
```
5安装 Blender 插件

把插件复制到 Blender 插件目录并命名为 blender_mcp.py，命令会打印写入路径并备份被替换的文件。
```
uvx mcp-for-blender install-addon
```
6启用插件

在 Blender 打开 Edit → Preferences → Add-ons，搜索并启用 MCP for Blender；未出现可 Install… 选文件或重启。
7启动 MCP 服务器

在 3D 视图按 N 打开侧边栏，切到 MCP for Blender 标签页，点击 Start MCP Server 建立连接。

关键配置

配置项	必填	说明	示例
`command`	是	MCP 客户端里要执行的命令，Docker 方式填 docker，pipx 方式填绝对路径	`docker`
`args`	是	Docker 方式必须包含 -i，服务端通过 stdin/stdout 与客户端通信	`["run", "-i", "--rm", "mcp-for-blender"]`
`BLENDER_HOST`	否	容器连接 Blender 的主机地址，镜像默认 host.docker.internal	`localhost`
`BLENDER_MCP_SAFE_MODE`	否	设为 1 在容器中启用安全模式	`1`
`BLENDERMCP_ADDONS_DIR`	否	覆盖插件安装的目标插件目录	`/path/to/scripts/addons`