适合谁
- VFX 艺术家和 TDs，希望使用 AI 助手加速 Houdini 工作流
- 需要程序化建模和模拟设置的用户
- 熟悉 Houdini 但希望自动化重复任务的用户
F
65FMRS · C
这是一个功能全面的 MCP 服务器，将 Houdini 的强大能力通过自然语言接口暴露给 AI。其丰富的工具集覆盖了 Houdini 几乎所有主要上下文，适合 VFX 艺术家和 TDs。但需要注意安全性和性能开销。
一个全面的模型上下文协议（MCP）服务器，用于 SideFX Houdini。它将 Claude 等 AI 助手直接连接到 Houdini 的 Python API，通过自然语言控制场景构建、模拟设置、渲染等。提供 188 个工具、8 个资源和 9 个提示，涵盖 31 个书面工作流指南。
工具能力
build_network
以原子验证的方式构建节点网络。
verify_network
验证节点网络的正确性和连接性。
get_node_doc
获取节点的文档卡片。
cook_profile
对节点进行烹饪性能分析。
cook_frame_range
按帧范围烹饪，提供每帧证据。
get_cook_status
获取节点的烹饪状态。
search_help
在 Houdini 官方手册中全文搜索。
get_help_page
获取特定手册页面内容。
open_scene
打开 Houdini 场景文件。
save_scene
保存当前场景。
import_scene
导入外部文件到场景。
export_scene
从场景导出文件。
get_scene_info
获取场景基本信息。
create_node
创建节点。
delete_node
删除节点。
copy_node
复制节点。
connect_nodes
连接两个节点。
layout_nodes
自动排列节点。
set_node_flags
设置节点的标志（如显示标志）。
get_parameters
批量获取节点参数。
set_parameters
批量设置节点参数。
set_parameter
设置单个参数。
get_parameter
获取单个参数。
set_expression
设置参数表达式。
set_keyframe
设置关键帧。
create_spare_parameter
创建备用参数。
get_points
获取几何体点信息。
get_prims
获取图元信息。
get_attributes
获取属性信息。
get_attribute_stats
获取属性统计。
inspect_volume
检查体积数据。
get_groups
获取组信息。
sample_points
采样点。
find_nearest_point
查找最近点。
get_stage_info
获取 USD 舞台信息。
get_prims_lops
获取 USD 图元。
get_layer_info
获取图层信息。
edit_layer
编辑 USD 图层。
set_variant
设置变体。
create_light
创建灯光。
get_sim_info
获取模拟信息。
get_dop_objects
获取 DOP 对象。
step_simulation
步进模拟。
reset_simulation
重置模拟。
get_memory_usage
获取内存使用情况。
cook_pdg
烹饪 PDG 图。
get_work_items
获取工作项。
list_schedulers
列出调度器。
get_dependency_graph
获取依赖图。
create_cop_node
创建 COP 节点。
get_image_info
获取图像信息。
get_layer_info_cop
获取 COP 图层信息。
get_vdb_info
获取 VDB 数据信息。
create_hda
创建 HDA。
install_hda
安装 HDA。
manage_hda
管理 HDA。
get_hda_sections
获取 HDA 的分区。
get_keyframes
获取关键帧。
set_keyframes
设置关键帧。
set_playbar
设置播放条位置。
get_frame_range
获取帧范围。
capture_viewport
捕获视口图像。
render_node
渲染节点。
set_render_settings
设置渲染设置。
launch_render
启动渲染。
create_wrangle
创建 VEX wrangle 节点。
edit_wrangle
编辑 VEX wrangle。
validate_vex
验证 VEX 代码。
run_python
在 Houdini 中执行 Python 代码。
run_hscript
在 Houdini 中执行 HScript。
run_expression
在 Houdini 中执行表达式。
get_env
获取环境变量。
manage_pane
管理面板。
set_viewer_context
设置查看器上下文。
verify_camera
验证相机状态。
verify_renderer
验证渲染器状态。
screenshot
截取场景截图。
detect_errors
检测场景错误。
get_network_overview
获取网络概览。
get_cook_chain
获取烹饪链。
get_selection
获取当前选择。
get_scene_summary
获取场景摘要。
analyze_errors
分析场景错误。
setup_pyro
设置 Pyro 模拟。
setup_rbd
设置刚体模拟。
setup_flip
设置 FLIP 流体模拟。
setup_vellum
设置 Vellum 模拟。
setup_sop_chain
设置 SOP 链。
setup_render
设置渲染配置。
list_materials
列出材质。
inspect_material
检查材质。
create_material
创建材质。
create_shader_network
创建着色器网络。
get_channel_data
获取通道数据。
create_chop_node
创建 CHOP 节点。
export_channels
导出通道到参数。
list_caches
列出缓存。
inspect_cache
检查缓存。
clear_cache
清除缓存。
write_cache
写入缓存。
安装接入
- 使用 pip 安装：
pip install fxhoudinimcp - 运行安装程序：
python -m fxhoudinimcp install - 重启 Houdini 和 MCP 客户端。
- 在 Houdini 菜单栏检查 MCP 菜单。
claude_desktop_config.json
{
"mcpServers": {
"fxhoudini": {
"command": "C:\\\\Program Files\\\\Python311\\\\python.exe",
"args": [
"-m",
"fxhoudinimcp"
]
}
}
}
选型与风险
不适合谁
- 没有安装 Houdini 20.5+ 的用户
- 需要实时交互式操作但网络延迟敏感的场景
- 对安全性要求极高，不能接受任意 Python 执行的场景
所需权限
- 访问 Houdini 的 Python API，执行任意 hou.* 调用
- 在 Houdini 主线程上运行代码，可能阻塞 UI
- 通过 HTTP 网络端口 (默认 8100) 与本地 Houdini 通信
- 可能读写文件，取决于使用的工具（如渲染、缓存）
风险与副作用
- 任意 Python 代码执行能力：如果 AI 指令不当，可能损坏场景或系统
- 网络端口暴露：默认绑定 loopback，但如果放宽绑定，可能被未授权访问
- 性能开销：每次调用有约 50 ms 的主线程延迟，大量调用会拖慢 Houdini
- 版本兼容性：过时的插件可能导致功能不正常
常见排障
- 没有 MCP 菜单：检查 Houdini 包日志（设置 HOUDINI_PACKAGE_VERBOSE=1）确认包文件加载
- 连接断开：运行 get_houdini_connection_status 检查连接，确保端口一致
- 插件未加载：检查包文件中路径是否存在，避免 BOM 编码问题
- 端口冲突：如果端口被占用，Houdini 会自动调整，客户端需扫描端口
使用场景
通过自然语言创建程序化岩石生成器
设置 Pyro 烟雾模拟
构建包含相机、灯光和地平面的 USD 场景
从选定子网创建 HDA
调试场景中的烹饪错误
支持客户端
Claude Desktop完整支持
Claude Code完整支持