Houdini MCP

Сервер Model Context Protocol (MCP), который бесшовно связывает ИИ-ассистентов (например, Claude, Cursor, Antigravity и Codecs) с работающей сессией Houdini Indie/FX.

Это позволяет вашему ИИ выполнять функции технического директора (TD): создавать ноды, соединять сети, запрашивать данные сцены, симулировать физику и изменять параметры в реальном времени.

🚀 Возможности

• Более 20 встроенных инструментов: чтение параметров, создание нод, соединение сетей VOPs/SOPs, перехват ошибок, сохранение .hip-файлов и т.д.

• Расширенное выполнение Python/HScript: даёт ИИ лазейку для запуска «сырого» Python-кода напрямую против объектной модели Houdini (hou).

• Полностью локально: взаимодействие происходит через stdio и 127.0.0.1. Никакие пользовательские данные сцены не покидают ваш компьютер.

Related MCP server: HoudiniMCP

🛠️ 1. Установка

Houdini использует внутреннее окружение Python, но наш MCP-сервер запускается извне. Поэтому нужно установить зависимости моста.

1. Склонируйте или скачайте этот репозиторий.

2. Дважды щёлкните по setup.bat (Windows).

   • Скрипт автоматически найдёт вашу установку Python 3, создаст виртуальное окружение .venv и установит fastmcp и rpyc==4.1.0 (эта версия совпадает с внутренней версией RPyC в Houdini).

(Примечание: если вы делаете это вручную, просто выполните pip install fastmcp rpyc==4.1.0)

🎩 2. Настройка Houdini

Вы должны сделать так, чтобы открытая сессия Houdini слушала команды ИИ. Сделать это можно двумя способами.

Вариант A: Автоматический запуск (рекомендуется)

Можно настроить Houdini так, чтобы он автоматически запускал соединение с ИИ в фоне каждый раз при старте — и вам не придётся делать это вручную.

1. Перейдите в папку пользовательских настроек Houdini (например, Documents/houdini21.0/ или Documents/houdini19.5/).

2. Откройте или создайте папку scripts.

3. Внутри scripts создайте файл с именем pythonrc.py и добавьте в него этот код:

# 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

Вариант B: Ручной запуск

Если вы хотите запускать соединение только в тот момент, когда оно действительно нужно:

1. Откройте Houdini (Indie, FX или Core).

2. Зайдите в Windows > Python Shell (или нажмите Alt + Shift + P).

3. Вставьте следующий фрагмент и нажмите Enter:

import hrpyc
hrpyc.start_server(port=18811)

🤖 3. Подключение вашего ИИ (настройка клиента)

Вам нужно зарегистрировать этот сервер у MCP-совместимого ИИ-хоста. Понадобятся абсолютные пути и к исполняемому файлу Python внутри .venv, и к скрипту houdini_mcp_server.py.

🔹 Для Claude Desktop

Откройте файл конфигурации Claude Desktop:

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

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

Добавьте сервер:

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

🔹 Для Cursor / Cline

1. Откройте Cursor Settings > Features > MCP Servers.

2. Нажмите + Add New MCP Server.

3. Имя: Houdini

4. Тип: command

5. Команда: "C:\path\to\-Houdini-s-MCP-\.venv\Scripts\python.exe" "C:\path\to\-Houdini-s-MCP-\houdini_mcp_server.py"

🔹 Для Antigravity

Откройте ~/.gemini/config/mcp_config.json и добавьте такой же JSON-блок, как в примере для Claude Desktop выше.

📝 Примеры запросов для вашего ИИ

После подключения попробуйте спросить ИИ:

• «Какой сейчас диапазон кадров в моей открытой сцене Houdini?»

• «Создай процедурный дом из куба и трубки, объедини их булевой операцией и помести их в RBD bullet solver.»

• «Найди все узлы в моей сети, которые в данный момент дают ошибки cooking, и скажи, какие именно ошибки.»

• «Сделай сферу /obj/geo1/sphere1 в 5 раз больше.»

Создано с использованием FastMCP и RPyC.