Houdini MCP 项目对比评测：capoomgit/houdini-mcp vs healkeiser/fxhoudinimcp

引言

随着 MCP（Model Context Protocol）协议的普及，越来越多的 DCC 软件开始接入 AI 助手。在 Houdini 生态中，目前有两个主要的 MCP 开源项目：

1. capoomgit/houdini-mcp — 早期项目，结构简洁
2. healkeiser/fxhoudinimcp — 后起之秀，功能全面

本文从架构设计、功能覆盖、安装体验、扩展性等维度进行对比，帮助选择适合自己工作流的项目。

总览对比

架构设计对比

houdini-mcp（capoomgit）

1

Claude Desktop  ──(stdio)──>  MCP Bridge Script  ──(TCP :9876)──>  Houdini Plugin

• 通信方式：MCP Bridge Script 通过 stdin/stdout 与 Claude 通信，通过自定义 TCP Socket 与 Houdini 通信。
• 服务端：自己实现的 HoudiniMCPServer，监听在 localhost:9876。
• 灵感来源：基于 blender-mcp 改写。

fxhoudinimcp（healkeiser）

1

Claude Desktop / Cursor / Claude Code  ──(stdio/streamable-http)──>  FXHoudini MCP Server  ──(HTTP :8100)──>  Houdini hwebserver

• 通信方式：MCP Server 通过 stdio 或 streamable-http 与 AI 客户端通信，通过 HTTP/JSON 与 Houdini 通信。
• 服务端：直接使用 Houdini 内置的 hwebserver，无需额外启动自定义服务器。
• 线程安全：使用 hdefereval.executeInMainThreadWithResult() 确保 hou.* API 调用在主线程执行。

架构差异分析

结论：fxhoudinimcp 的架构更稳健 — 复用 Houdini 原生组件，减少自定义代码带来的潜在问题。

功能覆盖对比

houdini-mcp 功能范围

提供基础的 Houdini 控制：

• 创建和修改节点
• 执行 Python / HScript 代码
• 场景基础操作
• OPUS 集成：通过 RapidAPI 接入 OPUS 的程序化家具和环境资产库（独有功能）

fxhoudinimcp 功能范围（19 个分类，168 个工具）

亮点：

• 一键工作流：Pyro、RBD、FLIP、Vellum 模拟一键搭建
• USD/LOPs 全面支持：18 个工具覆盖 USD 工作流
• Copernicus (COPs) 支持：图像处理节点操作
• 场景上下文分析：错误检测、Cook 链追踪

安装与配置对比

houdini-mcp 安装步骤

1. 安装 uv（Python 包管理工具）
2. 手动创建 Houdini 脚本目录并复制文件
3. 在目录中运行 uv add "mcp[cli]"
4. 手动创建 Shelf Tool
5. （可选）创建 Houdini Package JSON 实现自动加载
6. 配置 claude_desktop_config.json

1
2
3
4
5
6
7
8

{
  "mcpServers": {
    "houdini": {
      "command": "uv",
      "args": ["run", "python", "C:/path/to/houdini_mcp_server.py"]
    }
  }
}

fxhoudinimcp 安装步骤

1. pip install fxhoudinimcp（或 uv pip install fxhoudinimcp）
2. 复制 Package JSON 到 Houdini packages 目录
3. 配置 MCP 客户端

1
2
3
4
5
6
7
8
9
10
11
12

{
  "mcpServers": {
    "fxhoudini": {
      "command": "python",
      "args": ["-m", "fxhoudinimcp"],
      "env": {
        "HOUDINI_HOST": "localhost",
        "HOUDINI_PORT": "8100"
      }
    }
  }
}

Claude Code 支持（一行命令）：

1

claude mcp add --scope user fxhoudini -- python -m fxhoudinimcp

安装体验对比

客户端支持对比

独有功能

houdini-mcp 独有

• OPUS 集成：通过 RapidAPI 接入 OPUS 程序化资产库，可获取家具和环境资产。需要注册 RapidAPI 账号并订阅 API。

fxhoudinimcp 独有

• 一键模拟工作流：Pyro / RBD / FLIP / Vellum 一键搭建
• USD/LOPs 深度支持：18 个工具
• Copernicus 图像处理：COPs 节点操作
• 场景错误分析：自动检测和报告 Cook 错误
• 环境变量配置：HOUDINI_HOST、HOUDINI_PORT、FXHOUDINIMCP_AUTOSTART 等
• 双传输模式：stdio + streamable-http

适用场景建议

选择 houdini-mcp（capoomgit）的情况

• 只需要基础的 AI 控制 Houdini 功能
• 已经在使用 uv 工作流
• 需要 OPUS 程序化资产库的集成
• 项目结构简单，希望快速上手

选择 fxhoudinimcp（healkeiser）的情况

• 需要全面的 Houdini 功能覆盖（SOPs、LOPs、DOPs、TOPs、COPs 等）
• 需要 USD/LOPs 工作流支持
• 需要一键模拟工作流（Pyro / FLIP / Vellum / RBD）
• 希望使用标准化安装（PyPI 包）
• 使用 Claude Code CLI 作为主要 AI 工具
• 需要线程安全保障
• 重视项目的活跃维护和长期演进

结论

综合推荐：对于大多数用户，fxhoudinimcp 是更好的选择 — 更全面的功能覆盖、更稳健的架构、更便捷的安装流程。如果你特别需要 OPUS 程序化资产库的集成，可以额外关注 houdini-mcp。

参考链接

• capoomgit/houdini-mcp
• healkeiser/fxhoudinimcp
• blender-mcp — houdini-mcp 的灵感来源