FXHoudini MCP
MCP-сервер для SideFX Houdini на 215 инструментов: агент строит сети узлов, настраивает симуляции и собирает USD-сцены
- 382 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Инструмент execute_python выполняет произвольный код в сеансе Houdini, проверки подлинности и прав по инструментам нет
- Агент может удалять узлы, менять сцену и записывать файлы и кэши на диск
Установка
- Работает в
Ручная установка
pip install fxhoudinimcp && python -m fxhoudinimcp installПакетный файл Houdini и записи в клиентах пишутся одной командой. Флаг --dry-run покажет изменения без записи. Перезапустите Houdini и клиент.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструмент execute_python выполняет произвольный код в сеансе Houdini, проверки подлинности и прав по инструментам нет
- Агент может удалять узлы, менять сцену и записывать файлы и кэши на диск
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
FXHoudini MCP связывает ИИ-агента с запущенным Houdini через собственный Python API программы. Сервер работает в клиенте по stdio, а внутри Houdini загружается плагин с веб-сервером на порту 8100, который выполняет вызовы. Агент создает и соединяет узлы, меняет параметры пачками и правит ключи анимации. Он же смотрит стадии USD и запускает рендер. Инструменты разбиты на 24 группы, от узлов и параметров до LOPs, PDG и Copernicus. Для типовых задач есть вызовы, которые за один раз настраивают Pyro, RBD, FLIP и Vellum. Отдельные инструменты ищут по справке Houdini той же версии, что установлена у вас. К серверу прилагаются 8 ресурсов и 9 промптов с 31 руководством по рабочим процессам. Установка одной командой прописывает пакет Houdini и регистрирует сервер во всех найденных клиентах, а в меню Houdini появляется пункт MCP.
Для кого. Для технических художников и FX-специалистов в Houdini, которые хотят поручить Claude Code, Cursor или Codex сборку сетей, настройку симуляций и проверку сцены.
Подходит, если
- Нужно поднять с нуля симуляцию дыма, жидкости или ткани: Pyro, FLIP и Vellum настраиваются вызовом за один раз
- В сцене сотни узлов, и агенту надо найти узел с ошибкой, посмотреть цепочку расчета и время расчета узлов
- Требуется менять параметры и ключи анимации пачкой, без правки каждого узла вручную
- Нужно собрать USD-сцену: смотреть стадию, слои, варианты и освещение по ходу работы
- Надо выполнить код VEX или Python в сеансе Houdini и проверить его перед запуском
Не подходит, если
- У вас Houdini версии ниже 20.5
- Нужна жесткая изоляция: сервер рассчитан на одну рабочую станцию и доверенный клиент
- Сервер нужно открыть по сети: плагин привязан к loopback, а запросы с заголовком Origin и чужим Host отклоняются
- Вам нужен другой пакет 3D, например Blender: этот сервер работает только с Houdini
Пример запроса к агенту
Создай в Houdini куб, подключи к нему Pyro-симуляцию дыма, проверь сеть на ошибки и покажи кадр рендераMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
FXHOUDINIMCP_PROJECT_ROOT- Каталог проекта: инструменты открывают, сохраняют и экспортируют файлы только внутри него
FXHOUDINIMCP_BIND- Адрес привязки плагина вместо loopback
Ограничения
- Нужны Houdini 20.5 или новее (проверены 20.5, 21.0 и 22.0) и Python 3.10 или новее вне Houdini.
- Подключение к серверу равносильно оболочке внутри сеанса Houdini, проверки подлинности и прав по инструментам нет.
- Переменная FXHOUDINIMCP_PROJECT_ROOT ограничивает файлы, которые инструменты открывают, сохраняют, импортируют, экспортируют и устанавливают. Пути, записанные в параметры, и execute_python с execute_hscript она не контролирует.
- Откатить неудачное изменение можно только отменой в Houdini: один вызов инструмента равен одному шагу отмены.
- Для запуска плагина клиенту нужен абсолютный путь к тому Python, где установлен пакет: простое имя python показывается как отключенный сервер.
Как отключить. Выполните `python -m fxhoudinimcp uninstall`, а потом `pip uninstall fxhoudinimcp`. Первая команда убирает пакетный файл Houdini и записи в клиентах, без нее сервер перестает работать молча. Флаг `--dry-run` только покажет, что будет удалено.
Частые вопросы
Как поставить FXHoudini MCP?
Выполните `pip install fxhoudinimcp`, затем `python -m fxhoudinimcp install`. Команда прописывает пакетный файл в каждую найденную папку пакетов Houdini и регистрирует сервер во всех найденных клиентах, от Claude Code и Codex до Cursor и Cline. Перезапустите Houdini и клиент.
Как подключить сервер к Claude Code вручную?
Выполните `claude mcp add --scope user fxhoudini -- <python> -m fxhoudinimcp`, подставив абсолютный путь к Python с установленным пакетом. Другие клиенты регистрируют ту же команду своим способом.
Что значит отсутствие меню MCP в Houdini?
Скорее всего, Houdini не прочитал пакетный файл. Запишите его вручную командой `fxhoudinimcp houdini-package --write` в папку пакетов нужной версии и перезапустите Houdini.
Безопасно ли открывать доступ агенту?
Защиты на уровне инструментов нет: execute_python выполняет произвольный код. Плагин слушает только loopback и отказывает запросам из веб-страниц, а FXHOUDINIMCP_PROJECT_ROOT сужает доступные файлы.
Почему агент медленно работает с большими сетями?
Каждая команда ждет такта главного потока Houdini, около 50 мс даже на пустой сети. Десять узлов по одному вызову занимают около 800 мс, те же десять через build_network за один вызов около 66 мс.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыBlender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
DaVinci Resolve MCP
DaVinci Resolve MCP Server
MCP-сервер для управления DaVinci Resolve Studio через официальный Scripting API: монтаж, медиапул, рендер, грейдинг и Fusion
MCP-сервер для Windows, который управляет установленным Photoshop: документы, слои и произвольные скрипты JSX
Размещенный MCP-сервер Magic Hour: агент генерирует и редактирует видео, изображения и аудио через API сервиса
MCP-сервер для Adobe After Effects: создание композиций, слоев, ключевых кадров и выражений через агента
MCP-сервер для Adobe Photoshop: удаление фона, ретушь, экспорт для соцсетей и пакетные операции голосом
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| FXHoudini MCP (эта запись) | нет | не нужна | 382 | |
| Blender MCP | нет | не нужна | 32 717 | управляет Blender, а этот сервер работает только с SideFX Houdini |
| MCP for Unity | нет | не нужна | 15 537 | управляет редактором Unity и его проектами сцен |
Коротко о README
Проект под лицензией MIT держит справку частью сервера: промпты повторяют разделы справки SideFX, на каждую область вроде Pyro свое руководство. Для разработчиков есть интеграционные тесты в hython, которым нужна лицензия Houdini.