blender

BlenderMCP connects Blender with Claude AI to assist with modeling tasks, scene setup, and creative prompts. Once running, Claude can provide real-time guidance, generate scene elements from natural language prompts, and help with tasks like camera setup, lighting, and material suggestions directly while you work in Blender. The tool is designed to streamline your workflow by offering modeling insights, procedural suggestions, and prompt-based actions that integrate into your Blender session. To begin, ensure BlenderMCP is running and that Blender is configured to communicate with the MCP server so Claude can respond to your prompts within the Blender interface.

Prerequisites:

• Blender installed (3.0 or newer)
• Python 3.x installed and accessible from your command line
• Internet access for dependencies

Installation steps:

1. Download BlenderMCP: Visit the release link provided in the project and download the latest BlenderMCP ZIP file.
2. Extract the ZIP: Unzip the archive to a convenient location on your system.
3. Install Python dependencies (if needed): Open a terminal or command prompt in the extracted folder and run:
   • python -m pip install -r requirements.txt
4. Start the MCP server:
   • python -m blender_mcp
5. Connect Blender to the MCP server:
   • Open Blender and configure the MCP client to point to the server address (http://localhost:8000 by default).
6. Verify the connection:
   • In Blender, access the Claude-assisted tools and send a simple prompt like “Create a basic character with a torso, head, and limbs.”

If you encounter issues, consult the project’s Discord or FAQ page for troubleshooting tips.

Notes and tips:

• Ensure your Claude API key is set if required by BlenderMCP for access to Claude AI capabilities.
• Configure the MCP_PORT in both the Python environment and Blender client to ensure proper communication.
• If Blender cannot connect, check firewall settings and ensure the server is running on the expected host/port.
• Use simple prompts to build up complex scenes gradually; Claude can assist with modeling steps, lighting, and scene composition.
• Verify Blender version compatibility with the BlenderMCP plugin/module to avoid runtime errors.