fxhoudinimcp (Healkeiser)

fxhoudinimcp

The most comprehensive MCP server for SideFX Houdini.

168 tools across 19 categories, covering every major Houdini context.

##

目录

• 关于
• 特性
• 建筑
• 安装
• 用法
• 环境变量
• 发展
• 联系

关于

全面 主控程序 （模型上下文协议）服务器 SideFX胡迪尼.将Claude等人工智能助手直接连接到Houdini的Python API，实现对场景构建、模拟设置、渲染等的自然语言控制。

168工具, 8资源，以及 6个工作流提示 开箱即用。

特性

建筑

flowchart LR
    subgraph Client[" 🤖 AI Client "]
        direction TB
        A1("Claude Desktop")
        A2("Cursor / VS Code")
        A3("Claude Code")
    end

    subgraph MCP[" ⚡ FXHoudini MCP Server "]
        direction TB
        B1("🔧 168 Tools")
        B2("📦 8 Resources")
        B3("💬 6 Prompts")
    end

    subgraph Houdini[" 🔶 SideFX Houdini "]
        direction TB
        C1("🌐 hwebserver")
        C2("📡 Dispatcher")
        C3("🎛️ hou.* Handlers")
        C1 --> C2 --> C3
    end

    Client -. "MCP Protocol · stdio" .-> MCP
    MCP -. "HTTP / JSON · port 8100" .-> Houdini

    classDef clientBox fill:#f0f4ff,stroke:#b8c9e8,stroke-width:1px,color:#2d3748,rx:12,ry:12
    classDef mcpBox fill:#eef6f0,stroke:#a8d5b8,stroke-width:1px,color:#2d3748,rx:12,ry:12
    classDef houdiniBox fill:#fff5f0,stroke:#e8c4a8,stroke-width:1px,color:#2d3748,rx:12,ry:12

    classDef clientNode fill:#dbe4f8,stroke:#96b0dc,stroke-width:1px,color:#2d3748,rx:8,ry:8
    classDef mcpNode fill:#d4edda,stroke:#82c896,stroke-width:1px,color:#2d3748,rx:8,ry:8
    classDef houdiniNode fill:#fde4d0,stroke:#e0a87c,stroke-width:1px,color:#2d3748,rx:8,ry:8

    class Client clientBox
    class MCP mcpBox
    class Houdini houdiniBox
    class A1,A2,A3 clientNode
    class B1,B2,B3 mcpNode
    class C1,C2,C3 houdiniNode

使用Houdini的内置 hwebserver。没有自定义套接字服务器，没有rpyc。用途 hdefereval.executeInMainThreadWithResult() 安全奔跑 hou.* 调用主线程。

安装

需求

• 胡迪尼 20.5+（21.0测试）
• python 3.10+
• MCP-SDK (mcp 包装）1.8+

1.安装MCP服务器

来自PyPI：

pip install fxhoudinimcp

来源：

pip install -e .

或者具有开发依赖性：

pip install -e ".[dev]"

2.安装Houdini插件

选项A：Houdini套餐（推荐）

1. 复制 houdini/fxhoudinimcp.json 到您的Houdini软件包目录：

- 窗户： %USERPROFILE%/Documents/houdiniXX.X/packages/ - Linux： ~/houdiniXX.X/packages/ - macOS： ~/Library/Preferences/houdini/XX.X/packages/

1. 编辑JSON文件以进行设置 FXHOUDINIMCP 指向 houdini 此仓库中的目录。

选项B：手动复制

复制以下内容 houdini/ 进入Houdini用户首选项目录，以便：

• scripts/python/fxhoudinimcp_server/ 在Houdini的Python路径上
• python3.Xlibs/uiready.py 自动启动服务器（复制与Houdini的Python版本匹配的文件夹）
• toolbar/fxhoudinimcp.shelf 出现在您的书架上

3.配置您的MCP客户端

克劳德桌面 (claude_desktop_config.json):

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

克劳德代码 （全局--每个项目都有）：

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

或者，要将其范围限定到单个项目，请添加 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "fxhoudini": {
      "command": "python",
      "args": ["-m", "fxhoudinimcp"]
    }
  }
}

\[！提示\] 如果Claude Desktop报告服务器为 断开，替换 "python" 随着 完全绝对路径 到你的Python可执行文件。Claude Desktop并不总是继承 您的系统路径。通过以下方式查找： ``shell python -c "import sys; print(sys.executable)" ` 然后在配置中使用结果，例如。 "command": "C:\\Program Files\\Python311\\python.exe"`. 更改任何配置后，完全退出Claude Desktop（系统托盘→ 退出）并重新启动。

用法

正常启动Houdini。当UI准备就绪时，插件会自动启动一次（由控制 FXHOUDINIMCP_AUTOSTART env变量）。启动脚本使用 uiready.py，它可以与其他Houdini软件包正确堆叠。您还可以通过以下方式手动切换 MCP服务器 货架工具。

连接后，您的AI助手可以：

"Create a procedural rock generator with mountain displacement"
"Set up a Pyro simulation with a sphere source"
"Build a USD scene with a camera, dome light, and ground plane"
"Create an HDA from the selected subnet"
"Debug why my scene has cooking errors"

环境变量

发展

# Install dev dependencies
pip install -e ".[dev]"

# Run linter
ruff check python/

# Run tests
pytest

运作原理

1. Houdini插件 (houdini/)：在Houdini的Python环境中运行。寄存器 @hwebserver.apiFunction 接收JSON命令的端点。用途 hdefereval.executeInMainThreadWithResult() 安全执行 hou.* 调用主线程。

1. MCP服务器 (python/fxhoudinimcp/)：使用FastMCP的独立Python进程。通过MCP协议显示167个工具、8个资源和6个提示。通过HTTP将工具调用转发给Houdini。

1. 桥 (python/fxhoudinimcp/bridge.py)：异步HTTP客户端，向Houdini的hwebserver发送命令并反序列化响应。处理连接错误和超时。

联系

项目链接： fxhoudinimcp

许可证

麻省理工学院