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