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

Laden Sie blender_mcp.py herunter
Öffnen Sie Blender
Gehen Sie zu Bearbeiten → Einstellungen → Add-ons
Klicken Sie auf den Dropdown-Pfeil (⌄) neben der Suchleiste
Wählen Sie Von Festplatte installieren...
Wählen Sie die heruntergeladene blender_mcp.py Datei aus
Aktivieren Sie das Addon, indem Sie das Kästchen neben "MCP Complete Server for Blender" markieren

Starten des Servers

Drücken Sie N im 3D-Viewport, um die Seitenleiste zu öffnen
Navigieren Sie zum Tab MCP Server
Klicken Sie auf Start Server
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: