ahujasid/blender-mcp

项目概览

该项目通过基于 TCP 套接字的 JSON 协议将 LLM 的指令转化为 Blender 内部的实际操作（如生成物体、编写代码），为 3D 资产的提示词驱动生成提供了具体且可验证的实践路径。

项目类型

MCP · AI 工作流

应用场景

文档办公

部署方式

查看项目说明

License

MIT

适合谁

• 希望通过文本提示加速 3D 场景搭建和模型操作的设计师与开发者。

核心能力

• 通过基于套接字的服务器将 AI 客户端连接到 Blender，支持双向数据交互。
• 在 Blender 中创建、修改和删除 3D 对象。
• 在对象上应用和修改材质及颜色。
• 获取有关当前 Blender 场景的详细信息。
• 从 AI 客户端在 Blender 中运行任意 Python 代码。
• 查看 Blender 视口的屏幕截图，以使 AI 更好地理解当前场景。
• 支持在远程主机上运行 Blender MCP。
• 添加了对 Hunyuan3D 的支持。

限制与风险

• 复杂的操作可能需要分解为较小的步骤来执行。
• execute_blender_code 工具允许在 Blender 中运行任意 Python 代码，这在生产环境中具有潜在危险性；使用前务必保存工作成果。

如何开始

• 需先安装 uv 包管理器和 Blender 插件，然后编辑 MCP 客户端的 JSON 配置以添加 uvx blender-mcp 命令，启动服务器并在 Blender 中点击连接。

核验依据

• GitHub 项目简介: Open-source MCP to use Blender with any LLM
• README: - Added Hunyuan3D support - View screenshots for Blender viewport to better understand the scene - Search and download Sketchfab models - Support for Poly Haven assets through the…
• README: - **Two-way communication**: Connect Claude AI to Blender through a socket-based server - **Object manipulation**: Create, modify, and delete 3D objects in Blender - **Material co…
• README: 1. **Blender Addon (`addon.py`)**: A Blender addon that creates a socket server within Blender to receive and execute commands 2. **MCP Server (`src/blender_mcp/server.py`)**: A P…
• README: - Blender 3.0 or newer - Python 3.10 or newer - uv package manager:

内容核验时间：