Houdini MCP

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten (wie Claude, Cursor, Antigravity und Codecs) nahtlos direkt mit einer laufenden Houdini Indie/FX-Session verbindet.

Dadurch kann Ihre KI direkt als Technical Director (TD) arbeiten: Nodes erstellen, Netzwerke verbinden, Szenendaten abfragen, Physik simulieren und Parameter in Echtzeit verändern.

🚀 Features

• 20+ integrierte Tools: Parameter lesen, Nodes erstellen, VOPs/SOPs verdrahten, Fehler erfassen, .hip-Dateien speichern, usw.

• Erweiterte Python/HScript-Ausführung: Bietet einen Ausweg für die KI, um rohen Python-Code direkt gegen das Houdini Object Model (hou) auszuführen.

• Vollständig lokal: Kommuniziert über stdio und 127.0.0.1. Keine proprietären Szenendaten verlassen Ihren Rechner.

Related MCP server: HoudiniMCP

🛠️ 1. Installation

Houdini verwendet eine interne Python-Umgebung, aber unser MCP-Server läuft extern. Wir müssen die Abhängigkeiten der Verbindung installieren.

1. Klonen Sie dieses Repository oder laden Sie es herunter.

2. Doppelklicken Sie auf setup.bat (Windows).

   • Dieser Vorgang findet automatisch Ihre Python-3-Installation, erstellt eine .venv-virtuelle Umgebung und installiert fastmcp und rpyc==4.1.0 (die der internen RPyC-Version von Houdini entsprechen).

(Hinweis: Wenn Sie dies manuell tun, führen Sie einfach pip install fastmcp rpyc==4.1.0 aus)

🎩 2. Houdini-Setup

Sie müssen Ihrer geöffneten Houdini-Sitzung mitteilen, dass sie auf die Befehle der KI hören soll. Es gibt zwei Möglichkeiten, dies zu tun:

Option A: Automatischer Start (empfohlen)

Sie können Houdini so konfigurieren, dass die KI-Verbindung bei jedem Start automatisch im Hintergrund gestartet wird, sodass Sie es nie manuell tun müssen.

1. Wechseln Sie zu Ihrem Houdini-Voreinstellungen-Ordner (z. B. Documents/houdini21.0/ oder Documents/houdini19.5/).

2. Öffnen Sie den Ordner scripts oder erstellen Sie ihn.

3. Erstellen Sie im Ordner scripts eine Datei mit dem Namen pythonrc.py und fügen Sie diesen Code ein:

# Start hrpyc server for AI MCP integration
try:
    import hrpyc
    hrpyc.start_server(port=18811)
    print("[Houdini MCP] hrpyc listener successfully started on port 18811")
except Exception:
    pass

Option B: Manueller Start

Wenn Sie die Verbindung nur dann ausführen möchten, wenn Sie sie explizit benötigen:

1. Öffnen Sie Houdini (Indie, FX oder Core).

2. Gehen Sie zu Windows > Python Shell (oder drücken Sie Alt + Shift + P).

3. Fügen Sie die folgenden Codeausschnitt ein und drücken Sie Enter:

import hrpyc
hrpyc.start_server(port=18811)

🤖 3. Verbindung zu Ihrer KI (Client-Einrichtung)

Sie müssen diesen Server bei Ihrem MCP-kompatiblen KI-Host registrieren. Dazu benötigen Sie die absoluten Pfade sowohl zum Python-Interpreter in .venv als auch zum Skript houdini_mcp_server.py.

🔹 Für Claude Desktop

Öffnen Sie Ihre Claude-Desktop-Konfigurationsdatei:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Fügen Sie den Server hinzu:

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\path\\to\\-Houdini-s-MCP-\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\-Houdini-s-MCP-\\houdini_mcp_server.py"]
    }
  }
}

🔹 Für Cursor / Cline

1. Öffnen Sie Cursor Settings > Features > MCP Servers.

2. Klicken Sie auf + Add New MCP Server.

3. Name: Houdini

4. Type: command

5. Command: "C:\path\to\-Houdini-s-MCP-\.venv\Scripts\python.exe" "C:\path\to\-Houdini-s-MCP-\houdini_mcp_server.py"

🔹 Für Antigravity

Öffnen Sie ~/.gemini/config/mcp_config.json und fügen Sie den gleichen JSON-Block wie im obigen Claude-Desktop-Beispiel hinzu.

📝 Beispiel-Prompts zum Ausprobieren mit Ihrer KI

Sobald Sie verbunden sind, versuchen Sie, Ihre KI zu fragen:

• "Was ist der aktuelle Frame-Bereich meiner offenen Houdini-Szene?"

• "Erstellen Sie ein prozedurales Haus aus einer Box und einer Röhre, verknüpfen Sie sie mit einer Booleschen Operation und geben Sie sie in einen RBD Bullet Solver."

• "Finden Sie alle Node in meinem Netzwerk, die aktuell Cook-Fehler haben, und nennen Sie mir, was die Fehler sind."

• "Mach die Kugel unter /obj/geo1/sphere1 5 Mal größer."

Erstellt mit FastMCP und RPyC.