Blender MCP for Antigravity (Windows Optimized)

中文文档 (Chinese Documentation)

A robust, Windows-optimized Model Context Protocol (MCP) server for Blender, specifically designed for Antigravity users.

This fork fixes the critical "invalid trailing data" error caused by Windows stdio text mode handling, ensuring a stable connection between Antigravity and Blender.

✨ Key Features

• Windows Native Binary Mode: Completely bypasses Windows text-mode \r\n issues.
• 21+ Tools: Full control over scene, objects, and external assets.
• Integrations: Built-in support for PolyHaven, Sketchfab, Hyper3D, and Hunyuan3D.
• Stable: Custom-built server (server.py) independent of unstable libraries.

🚀 Quick Start

1. Install Blender Addon

1. Open Blender (4.0+ recommended).
2. Go to Edit > Preferences > Add-ons > Install....
3. Select addon.py from this repository.
4. Enable the add-on ("3D Gen: Blender MCP Connect").

2. Configure Antigravity

Add the following to your Antigravity MCP configuration (mcp_config.json):

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

Note: Make sure to use the absolute path to your Python executable and the server.py file.

3. Usage

Once connected, you can ask Antigravity to:

• "Create a red monkey head"
• "Download a wooden table from PolyHaven"
• "List all objects in the scene"
• "Check if Sketchfab integration is working"

🧪 Testing

This repository includes a tests/ folder with scripts to verify functionality.

• You can ask Antigravity to "Run the tests in the tests folder" to self-diagnose issues.
• server.py is the main entry point, but tests/test_binary.py can verify low-level protocol health.