关于 Houdini MCP
Houdini MCP 将 SideFX Houdini 的场景查看、编辑、运行和文档能力连接到 Claude、Codex、Gemini 等 Agent。它支持视口截图与离线文档，并可在没有已打开 Houdini 时启动无头会话。
主要功能
- 01查看和编辑场景节点
- 02运行 cook、渲染与 PDG
- 03捕获视口和翻页动画
- 04执行 Python、HScript 与 VEX 检查
- 05读取本地 Houdini 文档
- 06批量构建节点网络
适用场景
- 01通过 Agent 检查或修改场景
- 02运行场景并查看渲染结果
- 03从视口截图构建反馈循环
- 04查询当前 Houdini 版本文档
MCP 相关
MCP 服务向客户端提供 Houdini 场景、编辑、运行、截图、代码执行和文档工具。服务通过本机连接与 Houdini 通信，也可启动无头 hython。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
20收录的工具列表 · 更新于 4 天前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| operations | array | 是 | 按顺序排列的步骤。每项格式为 {"tool": "<tool name>", "params": {...}}，其中包含该工具自身所需的参数。此服务中除 batch 外的任意工具。 |
详细介绍
Houdini MCP
将 SideFX Houdini 连接到 Claude、Codex、Gemini、Cursor、opencode 或 pi。
此 MCP 为你选择的 Agent 提供完整的 Markdown 文档和视口截图支持，从而实现良好的反馈循环和自主工作流。
安装
Windows
powershell -c "irm https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.bat -OutFile bootstrap.bat; .\bootstrap.bat"
macOS / Linux
curl -sSL https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.sh | bash
uv
uv tool install houdini-mcp-server && houdinimcp-install
安装程序会将插件添加到 Houdini，并将服务添加到你选择的 AI 客户端。请重启两者。
pi 还需要执行 pi install npm:pi-mcp-adapter。
Claude 插件
此仓库也是一个 Claude 插件，可用于 Claude Code 和你电脑上的 Cowork。它需要 uv。
该插件无需设置即可启动无头 Houdini。若要连接当前打开的 Houdini，请让 Claude 运行 houdini-setup 技能。
该插件运行的内容
uv run --frozen会根据插件文件夹中的uv.lock构建环境，然后启动此仓库中的 MCP 服务。- 服务仅与
localhost上的 Houdini 通信。它会根据请求从你的 Houdini 安装目录启动hython或houdini，并使用ffmpeg编码翻页簿影片。 docs使用 houdinimd-docs 从你的 Houdini 安装目录读取文档，不会通过网络发送任何内容。houdini-setup会在你批准后，将 HoudiniMCP 软件包写入你的 Houdini 首选项文件夹。- 没有任何工具会向远程服务发送数据。
execute会在你的 Houdini 会话中运行 Claude 编写的任意 Python 代码。
| 读取 | scene_overview node_inspect geometry_inspect stage_inspect select console |
| 编辑 | node_edit parm_set connect hda batch |
| 运行 | cook render pdg playbar scene_file |
| 查看 | capture：视口、摄像机、四视图或翻页书 |
| 代码 | execute：Python、HScript、表达式、VEX 检查 |
| 文档 | docs：通过 houdinimd-docs 离线查看当前构建版本的 Houdini 文档 |
| 会话 | session：状态；以无头模式或带窗口模式启动 Houdini |
没有打开 Houdini？服务会启动一个无头 hython。
batch 会在一次调用中构建整个网络，并且要么全部成功，要么全部失败：某个步骤失败时，会撤销之前的步骤。构建成功后，会返回已烹制的点数和图元数，以及发生错误的节点。
警告：
execute会在 Houdini 中运行任意 Python 代码。请保存你的工作。
故障排除
| 问题 | 解决方法 |
|---|---|
| 没有 Houdini 在监听桥接服务 | 启动 Houdini，或点击 HoudiniMCP 工具架上的 Toggle MCP Server。 |
| 没有 HoudiniMCP 工具架 | 重启 Houdini。houdinimcp-install --list 会显示插件的安装位置。 |
| 从 Git Bash 启动的 Houdini 没有插件 | Git Bash 会设置 HOME。将用户变量 HOUDINI_USER_PREF_DIR 设置为 %USERPROFILE%\Documents\houdini__HVER__。 |
capture 提示没有视口 | 当前会话处于无头模式。调用 session，并设置 action="start_gui"。 |
| 必须使用固定端口 | 为 Houdini 和桥接服务设置 HOUDINIMCP_PORT。如果不设置，插件会从操作系统获取一个空闲端口，并告知桥接服务使用哪个端口。 |
供 Agent 和脚本使用
没有终端时，安装程序不会询问任何问题，并采用默认设置。
houdinimcp-install --list # Houdini installs and clients found, as JSON
houdinimcp-install --yes --json # newest Houdini, every client found; JSON report
houdinimcp-install --houdini-version 22.0 --harness claude-code --yes
houdinimcp-install --dry-run --yes # change nothing
houdinimcp-install --uninstall # remove the plugin and every client entry
标志：--houdini-version none 跳过插件安装，--prefs-dir PATH 指定首选项文件夹，--harness none|all|KEY（可重复指定），--quiet-start 禁止首次启动时显示对话框。引导脚本会传递所有标志。
手动设置客户端：不带参数运行 houdinimcp-bridge。
Claude Code 可使用 claude mcp add --transport stdio houdini -- houdinimcp-bridge。
从克隆的仓库安装：uv run python -m bridge.onboarding.install。
目录结构：src/houdinimcp/ 是插件，也是在 Houdini 内部运行、监听 localhost:9877 的 TCP 服务。src/bridge/ 是 MCP 服务和安装程序。消息采用 JSON 格式，并带有 4 字节长度前缀。设置 HOUDINIMCP_NO_HEADLESS=1 可阻止无头启动。修改代码前，请先阅读 AGENTS.md。
基于 blender-mcp、 capoomgit/houdini-mcp、 eetumartola/houdini-mcp、 Houdini21MCP 和 fxhoudinimcp 构建。采用 MIT 许可证。
与 SideFX 无关联。Houdini 和 SideFX 是 SideFX Software Inc. 的商标。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。