Blender

This Blender MCP Server turns Blender into an MCP-enabled API playground. Once the addon script is running, the server exposes a FastAPI-based HTTP interface at port 8000 with more than 50 tools that let you create and manipulate objects, materials, animations, cameras, lights, physics simulations, geometry nodes, file I/O, and scene management. You can discover available tools, invoke specific tools, and inspect results via the provided endpoints. For integration with AI agents, you can connect PolyMCP and use the endpoint /mcp/invoke/{tool_name} to perform operations or chain multiple tools for multi-step tasks. The /docs endpoint provides interactive API documentation, while /mcp/list_tools enumerates all available tools, categorized by capability (Object Operations, Transformations, Materials & Shading, etc.).

Prerequisites:

• Blender 3.0+ installed on your machine
• Basic familiarity with Blender and Python

Installation steps:

1. Download the Blender MCP server script: blender_mcp.py
2. Open Blender and install the addon script via:
   • Edit → Preferences → Add-ons
   • Install from Disk… and select blender_mcp.py
   • Enable the addon by checking 'MCP Complete Server for Blender'
3. Place blender_mcp.py in a known location (the same directory where you will run it from is fine)
4. Run the server:
   • Open Blender, press N to open the sidebar, go to the MCP Server tab, and click Start Server
   • By default the server will be available at http://localhost:8000

Alternatively you can run directly from a terminal (outside Blender) if the script is designed for standalone execution:

python blender_mcp.py

First-run setup will install required dependencies automatically (FastAPI, Uvicorn, Pydantic, and others) if you have network access.

Tips and troubleshooting:

• The server runs on port 8000 by default; if you need a different port, edit the Config in blender_mcp.py or set the PORT env var when launching.
• If the server cannot start, check Blender's System Console (Window → Toggle System Console) for errors and ensure port 8000 is not in use by another process.
• If dependencies fail to install automatically, install them manually inside Blender's Python environment: /path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy
• The API docs are available at http://localhost:8000/docs; use /mcp/list_tools to see all tools and /mcp/invoke/{tool_name} to run a tool.
• For production use, consider running Blender headlessly or in a dedicated environment; the addon is designed for thread-safe operation and queues multiple requests safely.