AI导哈

Blender实时控制服务

BlenderMCP是一个通过Socket通信实现Claude Desktop对Blender 5.0.1进行实时控制的MCP服务器，支持Windows 10系统，提供快速响应和实时交互功能。

  • by Aryeon0228
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Aryeon0228/BlenderMCP

使用说明

搅拌机MCP

Claude Desktop中实时控制Blender 5.0.1的MCP服务器-支持Windows 10

Blender addon作为套接字服务器与Claude Desktop通信。快速响应和实时交互。

📋 需求

  • 操作系统：Windows 10
  • 搅拌机：5.0.1版本
  • python：3.8或更高版本
  • 克劳德桌面版：最新版本

🎯 体系结构

Claude Desktop → MCP Server (Python) → Socket (localhost:9876) → Blender Addon

特点:

  • 快速响应（继续运行Blender）
  • 实时视口截图
  • 双向通信
  • 连续快速执行多个命令

🚀 安装方法

步骤1:验证安装Python

在命令提示符（CMD）中：

python --version

如果没有Python Python官方网站请在中安装。

步骤2：克隆存储库

git clone https://github.com/Aryeon0228/BlenderMCP.git
cd BlenderMCP

步骤3:安装Python软件包

pip install -r requirements.txt

或：

python -m pip install -r requirements.txt

步骤4:安装Blender Addon

4-1.检查addon.py文件

BlenderMCP 文件夹中 addon.py 请确认是否有文件。

4-2.在Blender中安装addon

  1. 运行Blender 5.0.1

  2. Edit → 偏好→ 附加组件

  3. 单击Install按钮

  4. addon.py 选择文件。 安装附加组件 单击

  5. **在搜索窗口中输入“MCP”**查找“Blender MCP Server”

  6. 启用复选框打开Addon

  7. 保存首选项 单击（自动加载）

4-3.验证服务器启动

  • Blender右侧边栏 “MCP” 出现制表符
  • 显示“Server Status:Running”时正常运行
  • Port:9876确认

如果服务器无法自动启动:

  • 在MCP选项卡上，单击“Start Server”按钮

步骤5：设置Claude桌面

5-1.打开配置文件

在Windows资源管理器地址窗口中输入：

%APPDATA%\Claude

5-2.创建/修改claude_desktop_config.json

如果文件不存在，则创建新文件，并添加以下内容：

{
  "mcpServers": {
    "blender": {
      "command": "python",
      "args": [
        "C:\\Users\\김소연\\BlenderMCP\\blender_mcp_server.py"
      ],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

重要:

  • 路径 实际安装位置请更改为
  • Windows路径两次反斜杠（\\）使用

5-3.重新启动Claude Desktop

请完全退出（在任务栏上）并重新运行。

🎨 可用功能

场景信息

  • get_scene_info -查看当前场景中的所有信息
  • get_object_info -特定对象的详细信息

创建和操作对象

  • create_object -创建对象（cube、sphere、cylinder、cone、plane、torus）
  • delete_object -删除对象
  • move_object -移动对象
  • scale_object -调整对象大小
  • rotate_object -旋转对象

材质和渲染

  • set_material -材质和颜色设置
  • render_scene -虚拟渲染
  • get_viewport_screenshot -视口截图（实时！）

高级功能

  • execute_blender_code 直接运行Python代码（bpy访问）
  • save_blend_file -保存.blend文件

💡 使用示例

在Claude Desktop中：

"블렌더 씬 정보를 보여줘"

"블렌더에 빨간색 큐브를 (0, 0, 0)에 만들어줘"

"현재 블렌더 화면을 스크린샷으로 보여줘"

"Cube라는 이름의 객체를 (2, 0, 0)으로 이동해줘"

"블렌더에서 구를 만들고 파란색으로 칠해줘"

🔧 故障排除

出现“Connection Error”

原因：Blender未运行或addon已禁用

解决:

  1. Blender 5.0.1运行确认
  2. 在Blender中Edit→Preferences→Add-ons
  3. 确认启用“Blender MCP Server”addon
  4. 在MCP选项卡中查看“Server Status:Running”

看不到Addon

解决:

  1. 完全退出Blender并重新运行
  2. 在Preferences→Add-ons中搜索“MCP”
  3. 如果没有，请重新安装addon.py
  4. 检查Blender版本（需要5.0或更高版本）

MCP服务器未连接

解决:

  1. Claude Desktop完全重新启动
  2. claude_desktop_config.json 验证路径
  3. 验证安装Python软件包： pip list | findstr mcp
  4. 直接运行MCP服务器测试：
    cd C:\Users\김소연\BlenderMCP
python blender_mcp_server.py

端口冲突

如果其他程序正在使用9876端口：

  1. 在Blender addon中更改端口（修改addon.py）
  2. 在Claude桌面设置中 BLENDER_PORT 变更

📁 项目结构

BlenderMCP/
├── addon.py                        # Blender addon (소켓 서버)
├── blender_mcp_server.py          # MCP 서버 (소켓 클라이언트)
├── requirements.txt                # Python 의존성
├── package.json                    # 프로젝트 메타데이터
├── mcp_config_example.json         # Claude Desktop 설정 예시
├── .env.example                    # 환경 변수 예시
└── README.md                       # 이 파일

🔄 工作原理

  1. 搅拌机插件：在Blender中运行套接字服务器（localhost:9876）
  2. MCP 服务器：Claude Desktop运行的Python进程
  3. 通信：基于JSON的命令/响应协议
  4. 执行：在Blender主线程上安全运行命令

性能比较

传统方法（subprocess）：

명령 실행 → Blender 시작 (10초) → 실행 → 종료

总时间：~ 10-15秒/命令

当前方式（socket）：

명령 실행 → 즉시 실행 (Blender 이미 실행 중)

总时间：~0.1-1秒/命令

快100倍以上！ 🚀

🤝 贡献

欢迎随时关注热点或PR！

原始存储库： ahujasid/搅拌机mcp

📄 许可证

MIT许可证

💬 支持

如果出现问题：

  1. 报告到GitHub Issues
  2. 检查Blender版本（5.0.1）
  3. 检查Python版本（3.8+）
  4. 检查日志： %APPDATA%\Claude\logs\mcp*.log

相关 MCP