Blender MCP for Antigravity

用于反重力的搅拌机MCP（Windows优化）

  

中文文档 (Chinese Documentation)

坚固， Windows优化 Blender的模型上下文协议（MCP）服务器，专为 反重力 用户。

此分叉修复了由Windows stdio文本模式处理引起的关键“无效尾随数据”错误，确保了Antigravity和Blender之间的稳定连接。

✨ 主要特点

• Windows本机二进制模式：完全绕过Windows文本模式 \r\n 问题。
• 21+工具：完全控制场景、对象和外部资产。
• 集成：内置对PolyHaven、Sketchfab、Hyper3D和Hunyuan3D的支持。
• 稳定：自定义服务器(server.py)独立于不稳定的库。

🚀 快速开始

1.安装Blender插件

1. 打开搅拌机（建议4.0+）。
2. 首选 Edit > Preferences > Add-ons > Install....
3. 选择 addon.py 从这个存储库。
4. 启用插件（“3D Gen：Blender MCP Connect”）。

2.配置反重力

将以下内容添加到您的反重力MCP配置中(mcp_config.json):

{
  "mcpServers": {
    "blender": {
      "command": "C:/Path/To/Your/python.exe",
      "args": [
        "D:/Path/To/This/Repo/server.py"
      ],
      "env": {
        "PYTHONUTF8": "1"
      }
    }
  }
}

备注：确保使用Python可执行文件的绝对路径和 server.py 文件。

3.使用方法

连接后，您可以要求Antigravity：

• “创造一个红猴头”
• “从PolyHaven下载木桌”
• “列出场景中的所有对象”
• “检查Sketchfab集成是否正常工作”

🧪 测试

此存储库包括 tests/ 文件夹中包含用于验证功能的脚本。

• 您可以要求Antigravity“在tests文件夹中运行测试”以自我诊断问题。
• server.py 是主要的切入点，但是 tests/test_binary.py 可以验证低级协议健康状况。