← 返回目录
H

Houdini MCP Server

社区
通过模型上下文协议(MCP)将SideFX Houdini连接到Claude。
GitHub 源仓库 ↗
★ 282 Stars 分类 · 开发工具 热门 源版本 de4fd93acc20
28FMRS · D
可靠性
4/20
安全与权限
2/20
维护活跃度
6/20
文档质量
8/20
安装易用性
8/20

该项目基于blender-mcp,提供从Claude到Houdini的本地控制。它功能丰富,但需要手动设置,并且不属于官方产品。文档清晰,但用户应谨慎处理权限和风险。

查看 FMRS 评分方法 →

HoudiniMCP是一个MCP服务器,允许你使用Claude控制SideFX Houdini。它由两部分组成:一个Houdini插件(Python包),监听本地端口(默认localhost:9876)并处理命令(创建和修改节点、执行代码等);以及一个MCP桥接脚本,通过stdin/stdout与Claude通信,并通过TCP与Houdini通信。该服务器需要uv和Houdini,并提供可选的OPUS集成,用于家具和环境程序资产。

工具能力

暂未整理工具清单。

安装接入

  1. 安装Houdini和uv。2. 在Houdini脚本目录中创建插件文件夹(例如,C:/Users/YourUserName/Documents/houdini19.5/scripts/python/houdinimcp/),并放入__init__.py、server.py和pyproject.toml。3.(可选)创建Shelf Tool或包集成以自动加载插件。4. 在插件目录中使用uv添加MCP:cd ... && uv add "mcp[cli]"。5. 配置Claude Desktop或Cursor,添加MCP服务器条目,指向houdini_mcp_server.py。6. 如果uv运行成功但Claude未能加载MCP,请确保Claude使用相同的Python版本,并将配置中的"python"替换为python -c "import sys; print(sys.executable)"输出的路径。7.(可选)通过复制urls.env.example到urls.env并添加RapidAPI密钥来设置OPUS集成。
claude_desktop_config.json
{
  "mcpServers": {
    "houdini": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

选型与风险

适合谁

  • 希望在Claude和Houdini之间建立无缝工作流程的Houdini艺术家和技术总监。
  • 希望利用AI辅助进行程序化3D建模和场景生成的用户。
  • 对MCP感兴趣并希望扩展Claude功能以涵盖3D工具的开发人员。

不适合谁

  • 没有Houdini许可证的用户(需要SideFX Houdini)。
  • 寻求官方支持的用户(此服务器不是由SideFX或Anthropic维护)。
  • 希望使用远程服务器且无法访问本地Houdini用户的用户(服务器在localhost上运行)。

所需权限

  • 本地网络访问:在localhost:9876上监听TCP连接。
  • 文件系统访问:在Houdini配置目录中读取和写入文件。
  • 执行权限:在Houdini上下文中执行Python代码。

风险与副作用

  • 在Houdini中执行不受信任的代码可能会导致数据丢失或系统损坏;仅在受信任的环境中使用。
  • 在本地主机上运行服务器可能会暴露给其他本地进程;确保没有恶意软件。
  • OPUS集成需要使用RapidAPI密钥,处理不当可能会泄露敏感信息。

常见排障

  1. 如果插件无法启动,请检查Houdini Python路径是否包含插件目录。
  2. 如果Claude无法加载MCP,请验证uv是否在PATH中,以及Claude使用的Python版本是否与uv环境匹配。
  3. 如果连接失败,请确保Houdini MCP服务器正在运行(通过Shelf Tool或包),并且端口9876未被占用。
  4. 如果OPUS工具被禁用,请检查urls.env文件是否存在且包含有效的RapidAPI密钥。

使用场景

使用自然语言从Claude控制Houdini,创建和修改节点。
在Houdini中执行Python代码以自动执行任务。
利用OPUS集成生成家具和环境程序资产。

支持客户端

Claude Desktop完整支持
Cursor完整支持