← 返回目录

FXHoudini MCP Server

社区

SideFX Houdini 最全面的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 50 / 438
Stars: ★ 325 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Python 3.10+
凭据: 无需凭据
许可证: MIT
最近提交: 6 天前
工具数: 100

65FMRS · C

这是一个功能全面的 MCP 服务器，将 Houdini 的强大能力通过自然语言接口暴露给 AI。其丰富的工具集覆盖了 Houdini 几乎所有主要上下文，适合 VFX 艺术家和 TDs。但需要注意安全性和性能开销。

最强项 · 文档质量 15/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

11/20

维护活跃度

15/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 11/20: 仓库展示了活跃的开发（大量提交、版本历史）和详细的测试描述（单元测试、集成测试、性能扫描）。虽然未直接检查源代码，但存在测试套件和 CI 工作流（推测在 .github 中）以及结构化错误处理可以提高可靠性。但由于未执行任何内容，且测试细节未验证，评分上限为 12。扣分原因：缺乏直接执行证据，无法确认声明工具与行为的一致性。
安全与权限 11/20: 架构显示本地回环绑定（127.0.0.1），且对安全风险有明确披露（‘桥接在 Houdini 会话中运行任意 Python，且无认证’）。默认绑定是安全的。未发现恶意指标。扣分原因：缺乏强制权限控制或明确确认机制的证据（如关键操作需二次确认），且未检查源代码以验证安全实现。评分低于完整级别。
维护活跃度 15/20: 仓库活跃：README 显示频繁提交、稳定发布（PyPI 版本）和 MIT 许可证。提交记录了持续的开发。扣分点：未直接检查 GitHub 仓库数据（如星标数、问题数），但按指示使用。README 显示的是积极维护徽章。
文档质量 15/20: 大型 README 覆盖了安装、架构、环境变量、开发和故障排除。包含配置示例（Claude Code、Claude Desktop）和详细解释。扣分点：未检查实际提示词文档或源代码，部分断言（如‘31 个工作流指南’）未在源码中验证，降低了证据强度。
安装易用性 13/20: 安装步骤清晰：需要通过 pip 安装并通过 `python -m fxhoudinimcp install` 进行设置，并为主要的 MCP 客户端提供具体配置示例。提供了手动安装细节和故障排除部分。扣分点：静态审查未验证这些步骤，且需要同时安装 Houdini 插件和 MCP 服务器增加了复杂性。静止演示得分上限为 15。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

VFX 艺术家和 TDs，希望使用 AI 助手加速 Houdini 工作流
需要程序化建模和模拟设置的用户
熟悉 Houdini 但希望自动化重复任务的用户

不适合谁

没有安装 Houdini 20.5+ 的用户
需要实时交互式操作但网络延迟敏感的场景
对安全性要求极高，不能接受任意 Python 执行的场景

所需权限

访问 Houdini 的 Python API，执行任意 hou.* 调用
在 Houdini 主线程上运行代码，可能阻塞 UI
通过 HTTP 网络端口 (默认 8100) 与本地 Houdini 通信
可能读写文件，取决于使用的工具（如渲染、缓存）

风险与副作用

任意 Python 代码执行能力：如果 AI 指令不当，可能损坏场景或系统
网络端口暴露：默认绑定 loopback，但如果放宽绑定，可能被未授权访问
性能开销：每次调用有约 50 ms 的主线程延迟，大量调用会拖慢 Houdini
版本兼容性：过时的插件可能导致功能不正常

安装接入

准备工作

运行环境：Python 3.10+

其他可选配置项（8 个）

HOUDINI_HOST 可选 MCP 服务器进程读取的 Houdini 主机地址，默认 localhost，在 MCP 客户端侧配置。

HOUDINI_PORT 可选 MCP 服务器进程读取的 hwebserver 端口，默认 8100，在 MCP 客户端侧配置；固定后会关闭 8100-8115 的端口扫描。

FXHOUDINIMCP_PORT 可选 Houdini 插件监听端口，默认 8100，写在 Houdini 包文件中，改了要同步 HOUDINI_PORT。

FXHOUDINIMCP_AUTOSTART 可选是否随 UI 就绪自动启动插件服务器，默认 1，设 0 关闭，写在 Houdini 包文件中。

FXHOUDINIMCP_AUTO_LAYOUT 可选是否自动布局节点，默认 1，设 0 保留手动布局，写在 Houdini 包文件中。

FXHOUDINIMCP_BIND 可选插件绑定地址，默认 127.0.0.1；桥接无鉴权，只在可信网络下放宽。

MCP_TRANSPORT 可选 MCP 传输方式，stdio 或 streamable-http，默认 stdio，在 MCP 客户端侧配置。

LOG_LEVEL 可选日志级别，默认 INFO，在 MCP 客户端侧配置。

使用 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "fxhoudini": {
      "command": "C:\\\\Program Files\\\\Python311\\\\python.exe",
      "args": [
        "-m",
        "fxhoudinimcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add fxhoudini -- 'C:\\Program Files\\Python311\\python.exe' -m fxhoudinimcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后重启 Houdini 和 MCP 客户端，在 Houdini 菜单栏确认出现 MCP 菜单；然后在客户端调用 get_scene_info 或 get_houdini_connection_status，能返回当前 Houdini 会话信息即说明桥接成功。

常见排障

没有 MCP 菜单：检查 Houdini 包日志（设置 HOUDINI_PACKAGE_VERBOSE=1）确认包文件加载
连接断开：运行 get_houdini_connection_status 检查连接，确保端口一致
插件未加载：检查包文件中路径是否存在，避免 BOM 编码问题
端口冲突：如果端口被占用，Houdini 会自动调整，客户端需扫描端口

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 /obj 下用 build_network 搭一个山体位移的程序化岩石生成器，并验证网络
帮我建一个以球体为源的 Pyro 模拟设置
看一下当前场景的网络概览，分析为什么有烹饪报错
把选中的子网打包成 HDA 并安装

工具能力 100

build_network 写入

以原子验证的方式构建节点网络。

verify_network 只读

验证节点网络的正确性和连接性。

get_node_doc 只读

获取节点的文档卡片。

cook_profile 只读

对节点进行烹饪性能分析。

cook_frame_range 只读

按帧范围烹饪，提供每帧证据。

get_cook_status 只读

获取节点的烹饪状态。

search_help 只读

在 Houdini 官方手册中全文搜索。

get_help_page 只读

获取特定手册页面内容。

展开其余 92 个工具

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 写入

写入缓存。

使用场景

通过自然语言创建程序化岩石生成器

设置 Pyro 烟雾模拟

构建包含相机、灯光和地平面的 USD 场景

从选定子网创建 HDA

调试场景中的烹饪错误

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

一个全面的模型上下文协议（MCP）服务器，用于 SideFX Houdini。它将 Claude 等 AI 助手直接连接到 Houdini 的 Python API，通过自然语言控制场景构建、模拟设置、渲染等。提供 188 个工具、8 个资源和 9 个提示，涵盖 31 个书面工作流指南。