Skip to main content
Glama
mgi24

Blender MCP (Fork)

by mgi24
README.md
# Blender MCP (Fork)

This repository is a fork of the original [ahujasid/blender-mcp](https://github.com/ahujasid/blender-mcp). 
Please visit and read the original repository for comprehensive documentation, features, and advanced usage instructions. 

This fork focuses on providing a simplified and straightforward installation process.

## Quick Installation Guide

Follow these 3 easy steps to install and set up Blender MCP:

1. **Run the Installer:**
   Execute the `INSTALL_UVX.bat` file in this directory. This will automatically set up the required dependencies.

2. **Install the Blender Add-on:**
   Copy the `addon.py` file and install/enable it inside your Blender application as an add-on.

3. **Configure Antigravity MCP:**
   Open your Antigravity MCP configuration folder and copy the settings provided in the `antigravity.json` file into your MCP configuration.

---
*For troubleshooting and detailed documentation, please refer to the [original repository](https://github.com/ahujasid/blender-mcp).*

TDQS

B3.4/5.0

Scored across 22 tools

Disambiguation3/5

Tools cluster into clear provider groups (Polyhaven, Sketchfab, Hyper3D, Hunyuan3D), but within 3D generation, generate_hyper3d_model_via_text, generate_hyper3d_model_via_images, and generate_hunyuan3d_model are near-interchangeable from an agent's perspective, differing only by backend service. The parallel poll/import pairs are distinguishable mostly because of naming luck, and set_texture's relationship to download_polyhaven_asset is ambiguous.

Naming Consistency4/5

Consistent snake_case verb_noun pattern and a clear provider-prefix convention (polyhaven_, sketchfab_, hyper3d_, hunyuan3d_) makes the set predictable. Deviations include set_texture (drops the provider prefix) and the inconsistent modifier ordering of import_generated_asset_hunyuan vs the pattern used elsewhere, which slightly breaks parallel structure.

Tool Count3/5

At 22 tools, the server is on the heavy side—reasonable given that it covers four asset providers plus scene introspection, but it exceeds the ideal 15-tool ceiling. The repeated status-poll-import triads across three generation backends inflate the count without adding conceptual surface area.

Completeness3/5

Each provider's core lifecycle is covered (status check, search, download/import for asset libraries; generate, poll, import for gen-AI models), and get_viewport_screenshot provides useful scene feedback. Gaps include no way to enumerate previously downloaded Polyhaven textures despite set_texture requiring a downloaded ID, no cancellation/list of active jobs, and execute_blender_code serving as an awkward catch-all for anything outside the defined tools.

Maintenance

ActivitySlowing
ResponsivenessNo issues