BlenderMCP连接问题分析与解决方案

问题现象分析

BlenderMCP是一个用于与Blender进行通信的Python工具包。用户在使用过程中遇到了连接建立后无响应的问题，具体表现为：

1. 服务端日志显示成功连接到Blender（localhost:9876）
2. 连接建立后进程挂起，无后续响应
3. 强制终止时出现CancelledError异常
4. 测试直接运行Python脚本可以正常工作

技术背景

BlenderMCP通过TCP套接字与Blender建立持久连接，使用基于消息的通信协议。这种架构允许外部程序与Blender进行双向通信，但同时也带来了连接管理的复杂性。

可能原因分析

1. 端口冲突问题

虽然日志显示连接成功，但可能存在隐性的端口冲突：

• 其他程序占用了9876端口
• Blender实例未正确释放端口
• 防火墙拦截了通信

2. 消息循环阻塞

从异常堆栈可以看出：

• 消息接收线程被阻塞在receive_event.wait()
• 这表明消息队列中没有收到预期数据
• 可能是Blender端未发送响应或消息格式不匹配

3. 多实例冲突

用户尝试了多个Blender版本，可能存在：

• 多个Blender实例同时运行
• 残留进程占用资源
• 版本兼容性问题

解决方案

1. 环境检查步骤

• 使用netstat -ano检查9876端口占用情况
• 确保只有一个Blender实例运行
• 检查系统防火墙设置

2. 连接调试方法

• 启用详细日志：uvx blender-mcp --verbose
• 使用telnet测试端口连通性
• 检查Blender控制台是否有错误输出

3. 最佳实践建议

1. 启动顺序：

   • 先启动Blender并确保运行正常
   • 再启动MCP服务

2. 版本匹配：

   • 使用官方推荐的Python 3.7-3.10版本
   • 保持Blender和MCP版本兼容

3. 资源清理：

   • 彻底终止所有相关进程
   • 清除临时文件和缓存

技术深入

从异常堆栈分析，问题核心在于AnyIO库的消息接收超时。这表明虽然TCP连接已建立，但应用层协议握手未完成。可能的原因包括：

• Blender插件未正确加载
• 消息序列化/反序列化失败
• 线程死锁

总结

BlenderMCP连接问题通常源于环境配置或资源冲突。通过系统化的排查和规范的启动流程，大多数连接问题都可以解决。对于开发者而言，理解其底层通信机制有助于快速定位问题根源。