Skip to main content
Glama
Houdini MCP

Houdini MCP

by bennyjoel

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: Houdini MCP Server

🛠️ 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 构建。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects Houdini to Claude AI through Model Context Protocol, enabling AI-assisted 3D modeling, scene creation, simulation setup, and rendering through natural language commands.
      58
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Houdini by executing Python code, querying scene information, and creating nodes via the Model Context Protocol.
      2
      -