ahujasid/mcp-for-blender

项目概览

该项目把场景检查、材质控制、Blender Python 执行、API 与节点结构查询以及 GLB/FBX 导出放入同一套 MCP 工作流，并可通过不同端口连接多个 Blender 实例；同时提供可选安全模式，并支持多种第三方资产来源。

项目类型

MCP · AI Agent

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 适合希望通过兼容 MCP 的客户端和自行选择的 LLM 辅助操作 Blender 的三维创作者。
• 适合需要在一个工作流中组合场景检查、材质处理、Blender Python 执行和 GLB/FBX 导出的开发者。
• 适合需要让不同 MCP 客户端条目通过独立端口连接多个 Blender 实例的使用场景。

核心能力

• 获取当前 Blender 场景及其对象信息并返回给 MCP 客户端，为后续针对现有场景的操作提供上下文。该能力当前可用。
• 创建材质并将其应用到 Blender 对象，可用于由 MCP 工作流驱动对象的材质处理。该能力当前可用。
• 在 Blender 内执行 Python 代码；可选安全模式会校验脚本，并阻止部分文件、进程、网络和持久化相关操作。该能力当前可用，但生产环境需审查任意代码执行风险。
• 将完整场景、当前选择或具名对象导出为 GLB 或 FBX，便于交付给其他应用。该能力当前可用。
• 查询节点结构和 Blender Python API 参考，避免依赖猜测的插槽顺序或枚举名称。该能力当前可用。
• 通过为不同 MCP 客户端条目配置不同端口，使其分别连接多个 Blender 实例。该能力当前可用。

限制与风险

• 复杂任务可能需要分成多个较小步骤执行，不能据此假定单次提示可稳定完成整个复杂建模过程。
• 快速入门文档警告，不要在同一套配置下同时运行 Cursor 与 Claude Desktop 的 MCP 服务器实例。
• Linux 上的文档化 Docker 路径要求使用主机网络，原因是 host.docker.internal 不可用且插件只监听本地主机。
• 当 Poly Pizza 的 CDN 屏蔽数据中心、VPN 或云 IP 地址时，资产下载可能失败。
• execute_blender_code 工具能够在 Blender 内运行任意 Python，项目明确提示这在生产环境中可能存在危险。
• 任何能够访问插件端口的一方都可能在 Blender 内运行 Python，因此不能把该端口直接暴露给不可信网络。
• 匿名使用遥测默认启用，相关数据可能用于研究和训练 AI 模型；如不接受该用途，需要主动关闭。
• 许多 Poly Pizza 资产要求注明创作者，导入和发布这些资产前需要处理相应署名合规事项。

如何开始

• 文档化快速入门要求 Blender 3.0 或更高版本、Python 3.10 或更高版本以及 uv 包管理器，因此整体配置难度为中等。
• 先安装 uv，将 MCP 客户端指向 mcp-for-blender 服务器；随后安装并启用 Blender 插件，在 Blender 的 MCP for Blender 侧边栏标签中启动服务器。

核验依据

• GitHub 项目简介: Community plugin to control Blender 3D with any LLM of your choice
• README: The system consists of two main components: 1. **Blender Addon** (`addon.py`) — a Blender addon that creates a socket server within Blender to receive and execute commands 2. **MC…
• README: - Get scene and object information - Create, delete and modify shapes - Apply or create materials for objects - Execute any Python code in Blender - Export the scene, the selectio…
• README: Three steps: install `uv`, point your MCP client at the server, install the Blender addon.
• README: **3. Install the Blender addon** ```bash uvx mcp-for-blender install-addon ``` Then in Blender: **Edit → Preferences → Add-ons** → enable **Interface: MCP for Blender**. **4. Conn…

来源更新时间：2026-09-16T18:06:24Z

打开原始 GitHub 项目