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

Open Blender (4.0+ recommended).
Go to Edit > Preferences > Add-ons > Install....
Select addon.py from this repository.
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.