Houdini MCP

一个 Model Context Protocol（MCP）服务器，可将 AI 助手（如 Claude、Cursor、Antigravity 和 Codecs）无缝桥接到实时 Houdini Indie/FX 会话。

这使你的 AI 能够直接扮演技术总监（TD）的角色：创建节点、连接节点网络、查询场景数据、模拟物理效果，并实时修改参数。

🚀 功能

• 20+ 内置工具：读取参数、创建节点、连接 VOP/SOP 节点、捕获错误、保存 .hip 文件等。

• 高级 Python/HScript 执行：为 AI 提供一个逃生通道，使其能够针对 Houdini 对象模型 (hou) 直接运行原始 Python/HScript。

• 完全本地化：通过 stdio 和 127.0.0.1 通信。任何专有场景数据都不会离开你的计算机。

Related MCP server: HoudiniMCP

🛠️ 1. 安装

Houdini 使用其内置的 Python 环境来运行，而我们的 MCP 服务器运行在外部。因此，我们需要安装这台桥接依赖。

1. 克隆或下载此存储库。

2. 双击 setup.bat (Windows)。

   • 这将自动查找你的 Python 3 安装，创建 .venv 虚拟环境，并安装 fastmcp 和 rpyc==4.1.0（它与 Houdini 内置的 RPyC 版本匹配）。

(注意：如果你想手动执行，请直接运行 pip install fastmcp rpyc==4.1.0)

🎩 2. Houdini 设置

您必须告知已打开的 Houdini 会话监听 AI 的命令。有两种办法：

选项 A: 自动启动 (推荐)

您可以配置 Houdini，使每次启动时自动启动 AI 连接在后台运行，这样您无需手动操作。

1. 进入你的 Houdini 偏好设置文件夹 (例如，Documents/houdini21.0/ 或 Documents/houdini19.5/)。

2. 打开或创建 scripts 文件夹。

3. 在 scripts 内创建一个名为 pythonrc.py 的文件，并添加以下代码：

   # Start hrpyc server for AI MCP integration
   try:
       import hrpyc
       hrpyc.start_server(port=18811)
       print("[Houdini MCP] hrpyc listener successfully started on port 18811")
   except Exception:
       pass

选项 B: 手动启动

如果您只想在你明确需要时才运行该连接：

1. 打开 Houdini (Indie、FX 或 Core)。

2. 转到 Windows > Python Shell（或按 Alt + Shift + P）。

3. 粘贴以下代码片段并按下 Enter：

   import hrpyc
   hrpyc.start_server(port=18811)

🤖 3. 连接到你的 AI（客户端设置）

您需要在兼容 MCP 的 AI 主机上注册本服务器。您需要 .venv 中 Python 可执行文件和 houdini_mcp_server.py 脚本的绝对路径。

🔹 在 Claude Desktop 中

打开你的 Claude Desktop 配置文件：

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

添加服务器：

{
  "mcpServers": {
    "houdini": {
      "command": "C:\\path\\to\\-Houdini-s-MCP-\\.venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\-Houdini-s-MCP-\\houdini_mcp_server.py"]
    }
  }
}

🔹 在 Cursor / Cline 中

1. 打开 Cursor 设置 > Features > MCP Servers。

2. 点击 + Add New MCP Server。

3. Name: Houdini

4. Type: command

5. Command: "C:\path\to\-Houdini-s-MCP-\.venv\Scripts\python.exe" "C:\path\to\-Houdini-s-MCP-\houdini_mcp_server.py"

🔹 For Antigravity

打开 ~/.gemini/config/mcp_config.json，并添加与上面 Claude Desktop 示例相同的 JSON 块。

📝 可尝试的示例提示词

连接成功后，尝试向你的 AI 提问：

• "当前打开的 Houdini 场景的帧率范围是多少？"

• "用一个 box 和一个 tube 创建一个程序化房屋，将它们进行布尔运算，然后放入一个 RBD Bullet 解算器中。"

• "找出我网络中所有存在烹饪错误的节点，并告诉我这些错误是什么。"

• "将 /obj/geo1/sphere1 处的球体放大 5 倍。"

由 FastMCP 和 RPyC 构建。