Houdini MCP

io.github.JTCHEv0.7.3更新于 Oct 4, 2026

Connect agents to SideFX Houdini: edit the scene, cook, render, see the viewport, read the docs.

已验证STDIO仅桌面Developer ToolsMedia & Design

概览

AI 生成的概览

让 AI 助手直接操作本机的 SideFX Houdini：查看和编辑场景、执行 cook 与渲染、截取视口画面并读取离线文档。

功能
该服务器把助手连接到同一台机器上运行的 SideFX Houdini。读取类工具包括场景总览、节点、几何体与 stage 检查、选择以及控制台输出；编辑类工具包括节点编辑、参数设置、连接、HDA 和批量网络构建。运行类工具可执行 cook、渲染、PDG 以及播放条和场景文件操作，capture 可截取视口、相机、四视图或 flipbook 画面，execute 可运行 Python、HScript 或表达式，docs 则离线返回所装版本的 Houdini 文档。
适用场景
适合让助手直接在 Houdini 内部工作：搭建或调整节点网络、检查几何体、执行 cook 与渲染，或通过视口截图确认结果。它面向需要反复迭代的自主 3D 工作流，而不是零散地询问 Houdini 问题。
运行要求
以 PyPI 包 houdini-mcp-server 通过 stdio 在本机运行，使用插件方式时需要 uv。需要安装 SideFX Houdini；若没有打开的会话，服务器可启动无界面的 hython，flipbook 编码使用 ffmpeg。通信仅在 localhost 上进行。未声明账号、API 密钥或环境变量，但提到可用 HOUDINIMCP_PORT 和 HOUDINI_USER_PREF_DIR 配置端口与偏好目录。
安装前请注意
execute 工具会在 Houdini 会话中运行任意 Python，未保存的工作可能丢失或损坏，使用前请先保存。安装程序会把 HoudiniMCP 包写入 Houdini 偏好目录，并向 AI 客户端添加条目，卸载时会移除这些内容。README 说明没有工具会把数据发送到远程服务，docs 在本地读取文档。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Houdini MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Houdini MCP

[An illustration titled "Houdini MCP", showing three agent platforms linked to the NodebookMD icon]

[PyPI Version] [License: MIT] [Python 3.10+] [MCP Compatible] [Houdini 22.0]

Connect SideFX Houdini to Claude, Codex, Gemini, Cursor, opencode or pi.

This MCP provides Full Markdown Documentation and Viewport Screenshots support to your agents of choice, enabling strong feedback loops and autonomous workflows.

Install

Windows

powershell
powershell -c "irm https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.bat -OutFile bootstrap.bat; .\bootstrap.bat"

macOS / Linux

bash
curl -sSL https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.sh | bash

uv

bash
uv tool install houdini-mcp-server && houdinimcp-install

The installer adds the plugin to Houdini and the server to your AI clients of choice. Restart both.
pi also needs pi install npm:pi-mcp-adapter.

Claude plugin

This repository is also a Claude plugin, for Claude Code and for Cowork on your computer. It needs uv. The plugin starts a headless Houdini without setup. To connect the Houdini that you have open, ask Claude to run the houdini-setup skill.

What the plugin runs
  • uv run --frozen builds an environment from uv.lock in the plugin folder, then starts the MCP server from this repository.
  • The server talks to Houdini on localhost only. It starts hython, or houdini on request, from your Houdini install, and ffmpeg to encode a flipbook movie.
  • docs reads the documentation out of your Houdini install with houdinimd-docs. It sends nothing over the network.
  • houdini-setup writes the HoudiniMCP package into your Houdini preferences folder, after you approve it.
  • No tool sends data to a remote service. execute runs any Python that Claude writes in your Houdini session.

Tools

Readscene_overview node_inspect geometry_inspect stage_inspect select console
Editnode_edit parm_set connect hda batch
Runcook render pdg playbar scene_file
Seecapture: the viewport, a camera, four views or a flipbook
Codeexecute: Python, HScript, expressions, VEX check
Docsdocs: the Houdini documentation of your build, offline, from houdinimd-docs
Sessionsession: status; starts Houdini headless or with its window

No Houdini open? The server starts a headless hython.

batch builds a whole network in one call, and it is all or nothing: a failed step undoes the steps before it. A build that works comes back with the cooked point and primitive counts, and the nodes with errors.

Warning: execute runs any Python in Houdini. Save your work.

Troubleshooting
ProblemFix
No Houdini listens for the bridgeStart Houdini, or click Toggle MCP Server on the HoudiniMCP shelf.
No HoudiniMCP shelfRestart Houdini. houdinimcp-install --list shows where the plugin went.
Houdini started from Git Bash has no pluginGit Bash sets HOME. Set the user variable HOUDINI_USER_PREF_DIR to %USERPROFILE%\Documents\houdini__HVER__.
capture says there is no viewportThe session is headless. Call session with action="start_gui".
You must have a fixed portSet HOUDINIMCP_PORT for Houdini and for the bridge. Without it, the plugin takes a free port from the operating system and tells the bridge which one.
For agents and scripts

Without a terminal, the installer asks nothing and takes the defaults.

bash
houdinimcp-install --list          # Houdini installs and clients found, as JSONhoudinimcp-install --yes --json    # newest Houdini, every client found; JSON reporthoudinimcp-install --houdini-version 22.0 --harness claude-code --yeshoudinimcp-install --dry-run --yes # change nothinghoudinimcp-install --uninstall     # remove the plugin and every client entry

Flags: --houdini-version none skips the plugin, --prefs-dir PATH names the prefs folder, --harness none|all|KEY (repeatable), --quiet-start stops the first-launch dialogs. The bootstrap scripts pass every flag through.

Manual client setup: run houdinimcp-bridge with no arguments. claude mcp add --transport stdio houdini -- houdinimcp-bridge for Claude Code.

From a clone: uv run python -m bridge.onboarding.install.

Layout: src/houdinimcp/ is the plugin, a TCP server inside Houdini on localhost:9877. src/bridge/ is the MCP server and the installer. Messages are JSON with a 4-byte length prefix. HOUDINIMCP_NO_HEADLESS=1 stops the headless start. Read AGENTS.md before you change code.

Credits

Built on blender-mcp, capoomgit/houdini-mcp, eetumartola/houdini-mcp, Houdini21MCP and fxhoudinimcp. MIT licensed.

Not affiliated with SideFX. Houdini and SideFX are trademarks of SideFX Software Inc.

来源：README.md，提交 23e13cc

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.7.3最新Oct 4, 2026