跳到主要内容
BetaFX & Simulation

MCP for Houdini — Connect AI Agents to Houdini

程序化工作本质上是一张意图图。Agent 拿到的是对这张图的类型化访问——节点、参数、表达式、VEX——并且计算范围被严格限定，问一个问题不会触发八小时的解算。

Install Houdini integrationComing soon
Read-only by default12 typed toolsCheckpointed writes
Technical specification
宿主软件
Houdini 20.5, 21 and newer (Core, FX, Indie)
运行时
Python 3.11 via hython and the Houdini Object Model
传输方式
stdio (local) and streamable HTTP (farm/submitter)
安装方式
Houdini package + npx dccmcp-houdini
覆盖系统
SOPs, VEX, HDAs, PDG/TOPs, USD, Karma, Mantra
支持平台
Windows, Linux, macOS
Last reviewed
2026-09-18
概述

什么是 MCP for Houdini？

MCP for Houdini is a local MCP server plus a Houdini plugin that connects AI agents to a real Houdini session. Agents discover 12 typed tools — including network.inspect, parm.inspect, node.create and node.connect — and call them to inspect, create, modify and validate work inside the live application.

Unlike generated Houdini scripts, every call is validated against your current document, classified as read, write or execute, and recorded in an audit log. Houdini stays open, the document stays live, and destructive operations are checkpointed so they can be rolled back.

It works with Claude Code, Codex, Cursor, GitHub Copilot, Claude Desktop, Gemini CLI, Trae, Doubao, Qwen Code, CodeBuddy, Custom MCP clients, Farm submitters over stdio or streamable HTTP.

  • 宿主软件: Houdini 20.5, 21 and newer (Core, FX, Indie)
  • 运行时: Python 3.11 via hython and the Houdini Object Model
  • 传输方式: stdio (local) and streamable HTTP (farm/submitter)
为什么会失败

没有契约时，让 Agent 驱动 Houdini 会出什么问题

01

改一个参数可能触发八小时的计算

程序化网络在某个上游被失效之前都很便宜。Agent 乱戳参数，可能排进一个谁都没要求的解算。

02

盲写的 VEX 编译不过

生成的片段常在类型不匹配、属性缺失或 run-over 上下文不对时失败——而报错出现在计算深处，不在编写的地方。

03

TOPs 图强大但难以看透

Work Item、依赖关系和属性恰恰是 Agent 擅长的结构化状态，前提是这张图能被检查，而不是靠猜。

如何工作

MCP for Houdini 如何保住设计意图、结构与可追溯性

一个 MCP Server 加一个 Houdini Package，把节点网络、参数、VEX 片段、数字资产、PDG/TOPs 图与 USD/Karma 输出暴露为类型化、带检查点的工具。

限定范围的计算

每个操作都要声明允许计算什么。Agent 拿到进度流和取消句柄，而不是被卡住的会话；也不会隐式失效任何上游。

绑定参数，而不是写死

工具接受字面值或通道引用，并会报告哪些参数仍是硬编码，让本该程序化的设置保持程序化。

带校验的 VEX

片段在写入节点前会先做 run-over 上下文、属性类型与绑定检查，编译错误以结构化结果返回。

把 PDG 当作类型化接口

Agent 检查 Work Item、设置属性与依赖、运行图的一个子集并读回失败项——和 TD 手动跑的循环完全一样。

工具参考

MCP for Houdini 工具清单与风险等级

Agent 在连接时就能发现这份清单。你可以决定哪些自动放行、哪些需要人工确认、哪些在生产文件中直接禁用。

工具名与参数签名保持英文——它们是 Agent 实际调用的接口。

  • network.inspectNode network structure, node types, flags, errors and warnings.read
  • parm.inspectParameter values, channel references, expressions and defaults.read
  • node.createCreate nodes in an explicit parent with validated type names.write
  • node.connectWire inputs and outputs with cycle detection before the edit lands.write
  • parm.setSet parameter values by component, with optional channel references.write
  • parm.expressionSet and evaluate HScript or Python expressions in context.write
  • vex.set_snippetAuthor a VEX snippet with run-over context validation and a compile check.write
  • hda.instantiateInstantiate digital assets and set typed, versioned parameter sets.write
  • geometry.cookCook a scoped node, stream progress and return geometry statistics.execute
  • pdg.runRun a scoped subset of a TOP graph and return per-work-item status.execute
  • usd.exportExport USD layers with explicit stage, root prim and unit settings.execute
  • cache.writeWrite geometry, volumes or simulation caches to declared paths.execute
安装

四步安装 MCP for Houdini

全部本地运行。服务默认只绑定回环地址，且只暴露你在 Houdini 中批准的工具。

预发布。 以下命令描述的是我们即将发布的接口，软件包尚未发布。 Get notified when MCP for Houdini launches.

STEP 01

安装 Houdini Package

把 DCCMCP Package 加进 Houdini 搜索路径。Package 文件让工作室级与项目级安装互不干扰。

export HOUDINI_PACKAGE_PATH=/studio/tools/dccmcp:$HOUDINI_PACKAGE_PATH
STEP 02

启动桥接服务

挂到正在运行的会话，或在农场节点上用 hython 做批量计算。

npx dccmcp-houdini@latest serve --mode attach
STEP 03

注册客户端

把服务注册到 Claude Code、Codex、Cursor、OpenClaw 或任何其他 MCP 客户端。农场节点用同一份配置的 HTTP 传输。

{
  "mcpServers": {
    "houdini": { "command": "npx", "args": ["dccmcp-houdini", "serve"] }
  }
}
STEP 04

限制计算开销

设置计算时长与内存上限，避免 Agent 在工作站上误触发完整解算。

dccmcp policy limits --cook-seconds 300 --memory 12Gi

MCP for Houdini works with the agents you already use

  • Claude Code
  • Codex
  • Cursor
  • GitHub Copilot
  • Claude Desktop
  • Gemini CLI
  • Trae
  • Doubao
  • Qwen Code
  • CodeBuddy
  • Custom MCP clients
  • Farm submitters

Any other MCP-compatible client works too — one config entry, stdio by default.

Read the docs
其他集成

常与 Houdini 搭配使用的其他 MCP 集成

MCP for Blender

Connect AI agents to Blender — scene graph, geometry nodes, renders and batch automation.

查看集成

MCP for Rhino

Drive Rhino and Grasshopper from an AI agent — NURBS, layers, blocks and parametric definitions.

查看集成

MCP for FreeCAD

Parametric CAD automation for agents — sketches, features, tech drawings and STEP exports.

查看集成

10 integrations available

Compare tool lists, support matrices and policies for every supported application.

Browse all integrations
常见问题

团队在安装前最常问的问题

如果没有覆盖到你的问题，直接写信给我们——技术问题我们给技术回答。

  • 不会。计算是带范围的显式工具调用，策略可以限制计算时长与内存。读取节点结构与参数值绝不会触发计算。

  • 支持。PDG 图以结构化数据暴露——Work Item、属性、依赖与结果——Agent 可以检查、运行子集并按 Work Item 汇报失败。

  • 可以编写 VEX 片段与参数表达式，并在提交到节点前完成校验。无效片段会以结构化编译错误返回，Agent 可自行修正。

  • Houdini 20.5、21 及更新版本，覆盖 Core、FX 与 Indie 授权。Indie 用户拿到同样的工具面，并行计算上限遵循你实际安装的授权。

  • 同一套工具可在农场节点上通过 hython 运行，缓存、USD 导出与渲染都以你的提交器已经认识的路径声明。

npx dccmcp-blender@latest serve

Put an agent inside your real tools — without putting your pipeline at risk

Install an integration, set a policy, and let your agent inspect, build and validate work in Blender, Maya, Houdini, 3ds Max, Rhino, ZBrush, Photoshop, FreeCAD, QGIS or OpenCV. Free to start, local by default.

Coming soonRead the quickstart

macOS · Windows · Linux — no cloud dependency required