AI导哈

Blender AI控制工具

通过AI控制Blender，实现3D建模、材质应用、场景渲染等功能，适用于3D设计和自动化工作流。

  • by flavioflavioflavio
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 flavioflavioflavio/blender-mcp-antigravity

使用说明

搅拌机MCP MERGE反重力

通过人工智能完全控制 Blender — 将最佳 MCP 工具融入 Antigravity IDE。

🔎 它是什么

此项目连接 搅拌机 奥 反重力 IDE 通过 模型上下文协议（MCP）它允许人工智能直接控制Blender - 创建对象，应用材料，生成3D模型，渲染场景等等，所有这些都通过自然语言。

统一最好的 ahujasid/搅拌机mcp e mezalstudio/反重力搅拌机mcp 在一个可用的包装中。

在行动中观看

延时摄影 Antigravity AI 通过 MCP 从头开始在 Blender 中生成完整场景。

https://github.com/user-attachments/assets/04046f6a-7b3e-4644-ba03-a5a3e391a283

🛠 30 可用工具

Categoria Tools Descrição
塞纳 get_scene_info, get_object_info, get_viewport_screenshot 检查场景，对象和捕捉截图
代码 execute_blender_code 在Blender中运行任何Python/bpy代码
蓝图 generate_blueprint 生成复杂的模型（建筑物，车辆，机器人，武器，自定义）
雕塑 sculpt_mesh 通过自然语言修改网格（12个操作）
程序性 generate_procedural 生成树木，岩石，土地和程序性建筑物。
材料 set_material_preset, apply_texture_from_file, set_texture 11 PBR 预设 + 文件或 URL 纹理
渲染 render_scene, bake_textures 渲染场景并制作纹理地图
优化 optimize_mesh 通过Decimate精确控制减少多边形
PolyHaven get_polyhaven_status, get_polyhaven_categories, search_polyhaven_assets, download_polyhaven_asset 免费的 HDRI、纹理和模型
Sketchfab get_sketchfab_status, search_sketchfab_models, get_sketchfab_model_preview, download_sketchfab_model 查找、查看和导入3D模型
Hyper3D get_hyper3d_status, generate_hyper3d_model_via_text, generate_hyper3d_model_via_images, poll_rodin_job_status, import_generated_asset 通过人工智能（文本或图像）生成3D模型
浑源3D get_hunyuan3d_status, generate_hunyuan3d_model, poll_hunyuan_job_status, import_generated_asset_hunyuan 通过Tencent AI进行3D生成

📋 先决条件

软件 最低版本 链接
搅拌机 3.0+ blender.org
Python 3.10+ python.org
紫外线 最后一个 星光sh/uv
Antigravity IDE 最新版本 反重力.dev

不稳定o uv 无窗口：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

📦 安装

步骤 1 — 在 Antigravity IDE 中配置

选项A - 粘贴GitHub链接（更简单）：

如果您使用 Antigravity IDE，只需在聊天中粘贴此仓库的链接即可：

https://github.com/flavioflavioflavio/blender-mcp-antigravity

Antigravity 会自动检测到 MCP 服务器，安装所有依赖关系并配置所有内容。稍后重新启动 IDE。

无需克隆，无需手动安装任何内容。粘贴链接，重新启动，就绪。

选项B - 在聊天中请求：

打开 Antigravity 聊天并发送：

"Configure o MCP server blender-mcp apontando para a pasta C:\caminho\para\este\repositorio"

Antigravity会处理其余的事情。

选项 C - 手动设置：

编辑文件 mcp_config.json 反重力（通常是 ~/.gemini/antigravity/mcp_config.json):

{
  "mcpServers": {
    "blender-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<CAMINHO_COMPLETO_DESTE_REPOSITORIO>",
        "blender-mcp"
      ]
    }
  }
}

替换 <CAMINHO_COMPLETO_DESTE_REPOSITORIO> 您克隆仓库的绝对路径。

Passo 2——不稳定的插件，没有搅拌机

打开Blender并进入 Edit → Preferences → Add-ons:

Clique em Install... 并选择文件 addon.py 从这个仓库的根：

通过选中复选框激活插件 BlenderMCP:

步骤 3 — 在 Blender 中启动服务器

无混合器， 压力 N 打开侧面板。查找标签 BlenderMCP e拉他们 启动MCP服务器:

步骤 4 — 连接

重新启动 Antigravity IDE。当服务器在 Blender 上运行时，连接将自动通过端口上的 TCP 进行 9876.

🚀 如何使用

只需在 Antigravity 中与 AI 交谈即可。它会自动选择要使用的工具：

"Crie um prédio cyberpunk com neon"
  → generate_blueprint(model_type="BUILDING", style="CYBERPUNK")

"Suavize a mesh do cubo"
  → sculpt_mesh(object_name="Cube", operation="smooth")

"Gere um terreno rochoso com seed 42"
  → generate_procedural(proc_type="TERRAIN", seed=42)

"Aplique material de ouro no objeto Sphere"
  → set_material_preset(object_name="Sphere", preset="GOLD")

"Renderize a cena em perspectiva isométrica"
  → render_scene(camera_angle="ISOMETRIC")

"Busque um modelo de cadeira no Sketchfab"
  → search_sketchfab_models(query="chair")

🏗 建筑

Antigravity IDE ↔ MCP Server (server.py) ↔ Socket TCP :9876 ↔ Blender Addon (addon.py) ↔ Blender Python API
组件 文件 功能
搅拌机插件 addon.py Blender插件，创建一个TCP服务器套接字来接收和执行命令。
MCP服务器 src/blender_mcp/server.py MCP服务器展示了30个Antigravity工具
工具 src/blender_mcp/tools/ 专业模块（蓝图、雕塑、程序、渲染等）

📂 项目结构

├── addon.py                      # Plugin Blender (socket server + lógica)
├── main.py                       # Entry point
├── mcp_config_example.json       # Exemplo de configuração MCP
├── pyproject.toml                # Definição do pacote Python
├── src/blender_mcp/
│   ├── server.py                 # Servidor MCP principal (30 tools)
│   ├── telemetry.py              # Telemetria anônima (desativável)
│   └── tools/
│       ├── blueprint.py          # Geração estrutural de modelos
│       ├── sculpt.py             # Modificação de meshes via linguagem natural
│       ├── procedural.py         # Geração procedural (árvores, rochas, terrenos)
│       ├── material_presets.py   # 11 presets PBR
│       ├── gentex.py             # Aplicação de texturas
│       ├── render.py             # Renderização de cenas
│       ├── bake.py               # Bake de mapas de textura
│       └── optimize.py           # Otimização de meshes (Decimate)
└── how_to_install/
    ├── index.html                # Guia visual completo (offline)
    ├── style.css
    └── images/                   # Screenshots do guia

⚠️ 重要说明

  • 哦 execute_blender_code 您可以在Blender中运行任意Python代码。 在使用之前保存您的工作。
  • 与 PolyHaven 和 Sketchfab 的集成必须在 Blender 的插件面板中启用。
  • Hyper3D提供每日限制的免费试用密钥。对于密集使用，请在 hyper3d.ai 或 fal.ai.
  • 遥测是匿名的，可以通过环境变量完全禁用 DISABLE_TELEMETRY=true.

📖 完整指南

除了这个 README 之外，存储库还包括一个 guia视觉离线 表情符号 how_to_install/index.html 包括所有 30 个工具的详细文档、使用示例和故障排除。

📜 学分

改编和统一 武本弗拉维奥.

| 作者 | 贡献者 | | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | ahujasid/搅拌机mcp | 悉达多Ahuja (@西达胡吉）项目基础：MCP服务器，addon.py，与PolyHaven，Sketchfab，Hyper3D和Hunyuan3D集成。 | mezalstudio/反重力搅拌机mcp | Mezalla 工作室 |先锋工具：蓝图、雕刻、程序生成、材质预设、渲染/烘焙、优化|

特别感谢A 悉达多Ahuja 通过 addon.py — Blender 插件，使所有通信成为可能。

📄 许可证

麻省理工学院 自由使用、修改和分发。

相关 MCP