Houdini MCP

Un servidor del Model Context Protocol (MCP) que conecta sin fricciones a asistentes de IA (como Claude, Cursor, Antigravity y Codecs) directamente con una sesión de Houdini Indie/FX activa.

Esto permite que tu IA actúe directamente como un Technical Director (TD): crear nodos, cablear redes, consultar datos de la escena, simular física y modificar parámetros en tiempo real.

Características

• Más de 20 herramientas integradas: Leer parámetros, crear nodos, cablear VOPs/SOPs, captur errores, guardar archivos .hip, etc.

• Ejecución avanzada de Python/HScript: Proporciona una vía de escape para que la IA ejecute Python original contra el Houdini Object Model (hódigo).

• Totalmente local: Se comunicdo a través de stdio y 127.0.0.1. Ninguna propietaria valiosa sale de tu máquina.

Related MCP server: HoudiniMCP

🛠️ Instancias 1. Instalación

Houdini usa un entorno Python interno, pero nuestro servidor MCP se ejecuta externamente. Tenemos que instalar las dependencias del puente.

1. Clona o descarga este repositorio.

2. Haz doble clic en setup.bat (Windows).

   • Esto buscará automáticamente tu instalación de Python 3, creará un entorno virtual .venv y instalará fastmcp y rpyc==4.1.0 (que coincide con la versión de RPyC interna de Houdini).

(Nota: si lo haces manualmente, simplemente ejecuta pip install fastmcp rpyc==4.1.0)

🎩 2. Configuración de Houdini

Debes indicar a tu sesión de Houdini abierta que escuche los comandos de la IA. Hay dos formas de hacerlo:

Opción A: Inicio automático (Recomendada)

Puedes configurar Houdini para que inicie automáticamente la conexión con la IA en segundo plano cada vez que se abra, de modo que nunca tengas que hacerlo manualmente.

1. Ve a tu carpeta de preferencias de Houdini (p. ej., Documents/houdini21.0/ o Documents/houdini19.5/).

2. Abre o crea la carpeta scripts.

3. Dentro de scripts, crea un archivo llamado pythonrc.py y añade este código:

   # 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

Opción B: Inicio manual

Si solo quieres ejecutar la conexión cuando la necesites explícitamente:

1. Abre Houdini (Indie, FX o Core).

2. Ve a Winddows > Python Shell (o pulsa Alt + Shift + P).

3. Pega el sigiente fragmento y pulsa Entur:

   import hrpyc
   hrpyc.start_server(port=18811)

🤖 3. Conexión con tu IA (Configuración del cliente)

Necesitas registrar este servidor con tu host de IA compatible con MCP. Necesitarás las rutas absolutas tanto al ejecutable de Python dentro de .venv como al script houdini_mcp_server.py.

🔹 Para Claude Desktop

Abre el archivo de configuración de Claude Desktop :

• Winddows: %APPATAA%\Claude\claude_desktop_config.json

• Mac: ~/Library/Application Support/Claude/claude_desktop config.json

Adede el servidor:

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

🔹 Para Cursor / Cline

Abre Cursor Settings > Features > MCP Servers. Haz clic en + Add New MCP Server.

Name: Houdini Type: command Command: "ruta:\C...python.exe" "ruta:C...u_server.py"

(Nota: si lo haces, simplemente ejecu pip install fastmcp rpyc==4.1.0)

📝 Ejemplos de prompts para pruear con tu IA

Una vez conectado, prueba a pedirle a la IA:

• "¿Cuál es el rango de profile actual de mi escena de Houdini abierta?"

• "Crea una casa procedural a partir de una caja y un tubo, bombardéalos juntos y ponlos en un solver de RBD bullet."

• "Encuentra todos los nodos de mi red que tienen errores de cocción actual y dime cuáles son."

• "Haz la esfera en /obj/geo1/sphera1" 5 veces mayor."

Construido con FastMCP y RPyC.