Blender模型上下文协议服务

一个专为Antigravity用户优化的Windows版Blender模型上下文协议服务器,支持21+工具和多种3D资源平台集成。

  • by kc0ed
  • Python
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 kc0ed/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 可以验证低级协议健康状况。