Houdini MCP: агент строит сети нод и симуляции в Houdini

healkeiser/fxhoudinimcp· Проверено 12.11.2026· 414на GitHub

Подключает агента к SideFX Houdini через плагин: собрать сеть нод, настроить симуляцию Pyro, RBD, FLIP или Vellum, разобрать USD-сцену, найти ошибки кука и отрендерить.

2 реализации:

215 инструментов, 9 промптов и встроенный поиск по справке Houdini; одна команда ставит плагин в Houdini и прописывает сервер в найденные клиенты.

Как подключить

Что сделать до подключения

Houdini 20.5 или новее и Python 3.10 или новее вне Houdini

pip install fxhoudinimcp, затем python -m fxhoudinimcp install: команда пишет файл пакета в Houdini и регистрирует сервер в клиентах

Перезапустить Houdini и клиент: в меню Houdini появится пункт MCP

В command указывать полный путь к тому Python, где стоит fxhoudinimcp

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio houdini \
  -- 'C:\Program Files\Python311\python.exe' -m fxhoudinimcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.houdini]
command = "C:\\Program Files\\Python311\\python.exe"
args = ["-m", "fxhoudinimcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "houdini": {
      "type": "stdio",
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "houdini": {
        "type": "local",
        "command": ["C:\\Program Files\\Python311\\python.exe", "-m", "fxhoudinimcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\Program Files\\Python311\\python.exe",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

build_networkстроит сеть нод за один вызов

verify_networkпоказывает ошибки нод

get_node_cardчитает параметры типа ноды

search_helpищет по справке Houdini

get_scene_infoчитает сведения о сцене

create_nodeсоздаёт ноду

connect_nodesсоединяет ноды

set_node_flagsставит флаги ноды

setup_pyro_simнастраивает симуляцию Pyro

setup_rbd_simнастраивает симуляцию RBD

setup_flip_simнастраивает жидкость FLIP

setup_vellum_simнастраивает ткань Vellum

cook_frame_rangeсчитает диапазон кадров

render_viewportснимает вьюпорт

render_sheetсобирает лист кадров

start_renderзапускает рендер

get_houdini_connection_statusищет запущенные Houdini

start_houdiniзапускает свой Houdini

execute_pythonвыполняет Python в Houdini

undoотменяет шаг

Показано 20 из 215.

Плагин на сокете порта 9876 по образцу blender-mcp: 25 инструментов для нод, параметров, VEX, геометрии и рендера, плюс процедурные модели OPUS.

Как подключить

Что сделать до подключения

SideFX Houdini, uv и Claude Desktop

Положить __init__.py, server.py, houdini_mcp_server.py и pyproject.toml в папку scripts/python/houdinimcp/ настроек Houdini

В этой папке выполнить uv add "mcp[cli]"

Запустить сервер в Houdini: кнопкой на полке с houdinimcp.start_server() или файлом пакета houdinimcp.json для автозагрузки

RAPIDAPI_KEY

Только для моделей OPUS: подписка на OPUS API на RapidAPI, ключ кладётся в urls.env, скопированный из urls.env.example

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio houdini-mcp \
  -- uv run python 'C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.houdini-mcp]
command = "uv"
args = ["run", "python", "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "houdini-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "houdini-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "houdini-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "houdini-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "houdini-mcp": {
        "type": "local",
        "command": [
          "uv",
          "run",
          "python",
          "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "houdini-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "houdini-mcp": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

Инструменты сервера

get_scene_infoчитает сведения о сцене

create_nodeсоздаёт ноду

connect_nodesсоединяет ноды

set_parametersзадаёт параметры

create_wrangleсоздаёт wrangle с VEX

find_error_nodesищет ноды с ошибками

get_geometry_infoчитает геометрию

render_quad_viewsрендерит четыре вида

execute_houdini_codeвыполняет Python в Houdini

opus_create_modelсоздаёт модель OPUS

Показано 10 из 25.

Что попросить агента

«Создай процедурный генератор камней со смещением в виде гор»Агент вызовет build_network и проверит результат через verify_network

«Настрой симуляцию Pyro с источником-сферой»Агент вызовет setup_pyro_sim

«Собери USD-сцену с камерой, купольным светом и плоскостью пола»Агент вызовет build_network и проверит сцену через verify_network

«Разберись, почему в сцене ошибки кука»Агент вызовет verify_network и покажет ноды с ошибками

«Покажи кадры 1–100 этой симуляции одним листом»Агент вызовет render_sheet

Для каких задач

Собрать процедурную сеть, например генератор камней, одной командой

Настроить симуляцию дыма, разрушений, жидкости или ткани с источником

Собрать USD-сцену с камерой, светом и полом

Найти, почему сцена считается с ошибками

Отрендерить кадр или собрать лист кадров без вьюпорта

Написать wrangle на VEX и проверить код

Ограничения

Подключение к серверу — это оболочка внутри Houdini: execute_python выполняет любой код, авторизации и прав на отдельные инструменты нет

Houdini, запущенный самим сервером через start_houdini, занимает место лицензии

Каждая команда ждёт такта главного потока Houdini, около 50 мс: 10 нод по одной строятся около 800 мс, одним build_network — около 66 мс

Инструкции HoudiniMCP написаны под Windows и пути Houdini 19.5; без ключа RapidAPI инструменты OPUS отключены

Если не работает

В Houdini не появляется меню MCP

Houdini молча пропустил файл пакета. Запустите его с HOUDINI_PACKAGE_VERBOSE=1: частые причины — неверный путь к плагину, BOM в начале файла, другой fxhoudinimcp.json в более позднем каталоге пакетов или другая версия Houdini.

Клиент показывает сервер как disconnected

В конфиге стоит просто python. Укажите абсолютный путь к Python, где установлен fxhoudinimcp.

Агент не может достучаться до Houdini

Вызовите get_houdini_connection_status: он перечислит все Houdini с плагином и причину, по которой подключение не удалось.

HoudiniMCP: uv run работает, но Claude не загружает сервер

Claude запускает другой Python. Узнайте путь командой python -c "import sys; print(sys.executable)" и подставьте его вместо python в конфиге.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
FXHoudini MCP	healkeiser	414	локально	не нужен	215	11 ноября 2026
HoudiniMCP	capoomgit	310	локально	не нужен	25	11 июня 2026

Частые вопросы

Можно ли работать в сцене, пока агент что-то строит?

Да. В FXHoudini MCP каждый вызов инструмента — один шаг отмены, а выделение, камера вьюпорта и редактор сети остаются на месте.

Как правильно удалить fxhoudinimcp?

Сначала выполните python -m fxhoudinimcp uninstall, потом pip uninstall fxhoudinimcp. Если удалить только пакет pip, файл пакета Houdini и запись в клиенте останутся и будут молча ломаться.

Что будет, если открыть два Houdini?

Второй Houdini займёт следующий свободный порт после 8100. Сервер сканирует порты 8100–8115, переключиться между сессиями можно инструментом connect_houdini.

Агент знает ноды моей версии Houdini?

FXHoudini MCP берёт параметры и входы из запущенного Houdini инструментом get_node_card и ищет по справке, которая идёт с Houdini, через search_help, без интернета.

Как подключить Houdini MCP к Claude Code?

Выполните claude mcp add --scope user fxhoudini -- <python> -m fxhoudinimcp, где <python> — полный путь к Python с установленным fxhoudinimcp. Команда python -m fxhoudinimcp install --client-only сделает это сама.

Как подключить Houdini MCP к Codex?

Для FXHoudini MCP: codex mcp add fxhoudini -- <python> -m fxhoudinimcp. Удаляется командой codex mcp remove fxhoudini.

Работает ли сервер из России?

Оба сервера работают на вашем компьютере рядом с Houdini, ключи не нужны; для моделей OPUS в HoudiniMCP нужна подписка на RapidAPI.

Houdini MCP: агент строит сети нод и симуляции в Houdini

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы