Blender MCP Server

Model Context Protocol (MCP) Server für die vollständige Blender-Steuerung via API

Dieses Addon verwandelt Blender in einen MCP-Server und stellt über 50 leistungsstarke Werkzeuge bereit, die von KI-Agenten über HTTP-Endpunkte gesteuert werden können. Perfekt für KI-gestützte 3D-Workflows, Automatisierung und kreative Experimente.

✨ Funktionen

• 🚀 50+ Werkzeuge - Volle Kontrolle über Blenders Funktionen:

  • Erstellung, Manipulation und Transformation von Objekten

  • Verwaltung von Material- und Shader-Systemen

  • Steuerung von Animationen und Keyframes

  • Kamera- und Beleuchtungseinrichtung

  • Modifikatoren und Constraints

  • Physikalische Simulationen (Rigid Body, Stoff, Flüssigkeiten)

  • Geometry Nodes und prozedurale Generierung

  • Datei-Import/Export-Operationen

  • Szenenoptimierung und Stapelverarbeitung

• 🔒 Thread-sichere Ausführung - Warteschlangensystem auf Unternehmensniveau für sichere gleichzeitige Operationen

• 📦 Automatische Abhängigkeitsinstallation - Installiert erforderliche Pakete automatisch beim ersten Start

• 🎮 Einfaches UI-Panel - Server mit einem Klick über Blenders N-Panel starten/stoppen

• 📊 Echtzeit-Überwachung - Verfolgen Sie Operationen, Statistiken und den Serverstatus

• 🔧 Produktionsbereit - Umfassende Fehlerbehandlung, Protokollierung und Caching

🚀 Schnellstart

Installation

1. Laden Sie blender_mcp.py herunter

2. Öffnen Sie Blender

3. Gehen Sie zu Bearbeiten → Einstellungen → Add-ons

4. Klicken Sie auf den Dropdown-Pfeil (⌄) neben der Suchleiste

5. Wählen Sie Von Festplatte installieren...

6. Wählen Sie die heruntergeladene blender_mcp.py Datei aus

7. Aktivieren Sie das Addon, indem Sie das Kästchen neben "MCP Complete Server for Blender" markieren

Starten des Servers

1. Drücken Sie N im 3D-Viewport, um die Seitenleiste zu öffnen

2. Navigieren Sie zum Tab MCP Server

3. Klicken Sie auf Start Server

4. Der Server startet unter http://localhost:8000

Das Addon installiert beim ersten Start automatisch die erforderlichen Abhängigkeiten (FastAPI, Uvicorn, Pydantic, etc.).

🤖 Verwendung mit PolyMCP

Dieser MCP-Server ist für die nahtlose Zusammenarbeit mit PolyMCP konzipiert – einem leistungsstarken Framework zur Orchestrierung von MCP-Servern mit KI-Agenten.

Beispiel: KI-gesteuertes Blender

#!/usr/bin/env python3
import asyncio
from polymcp.polyagent import UnifiedPolyAgent, OllamaProvider

async def main():
    # Initialize your LLM provider
    llm = OllamaProvider(model="gpt-oss:120b-cloud", temperature=0.1)
    
    # Connect to Blender MCP server
    agent = UnifiedPolyAgent(
        llm_provider=llm, 
        mcp_servers=["http://localhost:8000/mcp"],  
        verbose=True
    )
    
    async with agent:
        print("✅ Blender MCP Server connected!\n")
        
        # Chat with your AI to control Blender
        while True:
            user_input = input("\n🎨 You: ")
            
            if user_input.lower() in ['exit', 'quit']:
                break
            
            result = await agent.run_async(user_input, max_steps=5)
            print(f"\n🤖 Blender: {result}")

if __name__ == "__main__":
    asyncio.run(main())

Beispielbefehle

Sobald die Verbindung hergestellt ist, können Sie den KI-Agenten bitten:

• "Erstelle einen Würfel an Position (0, 0, 0) mit Größe 2"

• "Füge dem ausgewählten Objekt ein rotes metallisches Material hinzu"

• "Erstelle eine Kamera, die auf den Ursprung blickt"

• "Richte eine einfache Beleuchtungsszene mit 3 Lichtern ein"

• "Füge dem Würfel eine Flüssigkeitssimulation hinzu"

• "Exportiere die Szene als FBX-Datei"

• "Erstelle eine Animation, die das Objekt über 100 Frames um 360 Grad dreht"

Das war's! PolyMCP übernimmt die gesamte Komplexität von:

• Werkzeugerkennung und -auswahl

• Planung von mehrstufigen Aufgaben

• Fehlerbehandlung und Wiederholungsversuchen

• Zustandsverwaltung über Operationen hinweg

Dies macht es unglaublich einfach, KI-gestützte Blender-Automatisierungswerkzeuge zu erstellen!

📡 API-Endpunkte

Sobald der Server läuft, können Sie auf Folgendes zugreifen:

• API-Dokumentation: http://localhost:8000/docs

• Alle Werkzeuge auflisten: http://localhost:8000/mcp/list_tools

• Werkzeug aufrufen: POST http://localhost:8000/mcp/invoke/{tool_name}

🛠️ Verfügbare Werkzeugkategorien

• Objektoperationen: Erstellen, löschen, duplizieren, Objekte auswählen

• Transformationen: Verschieben, rotieren, skalieren, Transformationen anwenden

• Materialien & Shading: Materialien erstellen, Texturen hinzufügen, Shader-Nodes einrichten

• Modellierung: Modifikatoren hinzufügen, boolesche Operationen, Mesh-Bearbeitung

• Animation: Keyframes, Timeline-Steuerung, NLA-Editor

• Kamera & Beleuchtung: Kamera-Setup, Lichterstellung, HDRI-Umgebungen

• Rendering: Rendereinstellungen, Ausgabekonfiguration, Rendering

• Physik: Rigid Body, Stoff, Flüssigkeitssimulationen

• Geometry Nodes: Prozedurale Generierung, Node-Tree-Erstellung

• Dateioperationen: Import/Export verschiedener Formate (FBX, OBJ, USD, etc.)

• Szenenverwaltung: Szeneninfo, Bereinigung, Optimierung

• Stapelverarbeitung: Erstellung und Transformation mehrerer Objekte

• Erweitert: Partikelsysteme, Kraftfelder, Grease Pencil

🔧 Konfiguration

Sie können den Server anpassen, indem Sie die Config-Klasse in blender_mcp.py bearbeiten:

class Config:
    HOST = "0.0.0.0"           # Server host
    PORT = 8000                # Server port
    AUTO_INSTALL_PACKAGES = True  # Auto-install dependencies
    THREAD_SAFE_OPERATIONS = True  # Enable thread-safe execution
    ENABLE_CACHING = True      # Enable result caching

📋 Anforderungen

Das Addon installiert automatisch diese Abhängigkeiten:

• FastAPI

• Uvicorn

• Pydantic

• docstring-parser

• NumPy

• PolyMCP

Blender-Version: 3.0.0 oder höher

🐛 Fehlerbehebung

Server startet nicht?

• Überprüfen Sie die Systemkonsole von Blender auf Fehlermeldungen (Fenster → Systemkonsole umschalten)

• Stellen Sie sicher, dass Port 8000 nicht bereits belegt ist

• Versuchen Sie, Blender nach der Installation neu zu starten

Abhängigkeiten werden nicht installiert?

• Installieren Sie Pakete manuell über Blenders Python:

/path/to/blender/python -m pip install fastapi uvicorn pydantic docstring-parser numpy

MCP Server-Panel nicht gefunden?

• Drücken Sie N im 3D-Viewport

• Suchen Sie in der Seitenleiste nach dem Tab "MCP Server"

• Stellen Sie sicher, dass das Addon in den Einstellungen aktiviert ist

🤝 Mitwirken

Beiträge sind willkommen! Dieses Projekt zeigt, wie einfach es ist, leistungsstarke MCP-Server für PolyMCP zu erstellen.

📝 Lizenz

MIT-Lizenz - Siehe LICENSE-Datei für Details

🔗 Verwandte Projekte

• PolyMCP - Einfache und effiziente Art, mit MCP-Servern über benutzerdefinierte Agenten zu interagieren

• Model Context Protocol - Offenes Protokoll für die Werkzeugintegration mit LLMs

💡 Warum dieses Projekt?

Dieser MCP-Server wurde erstellt, um zu demonstrieren, wie unglaublich einfach PolyMCP die Erstellung von KI-gestützten Werkzeugen macht. Mit nur wenigen Zeilen Code können Sie:

1. Komplexe Blender-Funktionalität als MCP-Werkzeuge bereitstellen

2. KI-Agenten diese Werkzeuge entdecken und orchestrieren lassen

3. Natürlichsprachliche Schnittstellen für die 3D-Erstellung aufbauen

Kein komplexes Prompting, keine manuelle Werkzeugauswahl, keine Zustandsverwaltung – PolyMCP erledigt alles!

Entwickelt für PolyMCP

Gib diesem Repo einen Stern ⭐, wenn es dir nützlich ist!