← 返回目录

Houdini MCP Server

社区

通过模型上下文协议（MCP）将SideFX Houdini连接到Claude。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 419 / 438
Stars: ★ 305 热门
传输方式: stdio（本地进程）
运行环境: Python
凭据: 可选 API Key
许可证: MIT
最近提交: 4 个月前

28FMRS · D

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

最强项 · 安装易用性 8/20 最弱项 · 安全与权限 2/20

可靠性

4/20

安全与权限

2/20

维护活跃度

6/20

文档质量

8/20

安装易用性

8/20

查看各项评分依据

可靠性 4/20: 仅提供 README 和仓库元数据，没有服务器源码、测试或 CI 配置。无法验证 MCP 初始化握手、工具列表或工具的真实行为；README 描述的 happy path 看似合理，但缺少可复核的执行证据，因此按保守原则扣分。
安全与权限 2/20: README 描述 Houdini 插件在 localhost:9876 上监听，并处理创建/修改节点、执行代码等命令，但没有提及认证、授权或用户确认机制。这相当于无认证的本地命令执行服务，任何本地进程都可能触发任意 Houdini 代码执行，属于未缓解的远程命令默认风险，触发安全红线，故给 2 分。
维护活跃度 6/20: 仓库未归档且带有 MIT 许可证，但未提供提交历史、发布版本、依赖更新记录、安全响应渠道或 issue 响应证据；仅有星标数和 7 个开放 issue，不能作为维护活跃度的加分依据。维护状态缺乏可验证证据，评分保守。
文档质量 8/20: README 提供了安装步骤、uv 用法、Claude Desktop/Cursor 配置和可选的 OPUS 集成说明，但缺少工具参数参考、功能限制、成本说明、测试方法，且目录中承诺的 Testing & Usage 与 Troubleshooting 内容未见实际展开。文档可用但存在隐藏假设和明确缺口。
安装易用性 8/20: 安装步骤比较具体，给出了文件夹结构、Shelf Tool、packages 集成以及 Claude Desktop 配置示例，但整个过程依赖手动复制、手动配置 Windows 路径和 uv，缺少自动化验证或 CI/测试证据；静态校准要求 setup 最高 15 分且需可验证执行证据，因此不上调分数。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python

安装Houdini和uv。
在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 Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "houdini": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add houdini -- uv run python 'C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动 Houdini 并通过 shelf 工具开启 MCP 服务器（localhost:9876），然后在 Claude Desktop 的工具列表中确认出现 houdini 服务器的工具；也可以让 Claude 执行一条简单的节点创建命令来验证连接。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

在 Houdini 场景里创建一个几何节点网络
在 Houdini 中修改当前节点的参数
在 Houdini 的 Python 面板中执行一段代码
用 OPUS 工具加载一个家具资产到场景中

使用场景

使用自然语言从Claude控制Houdini，创建和修改节点。

在Houdini中执行Python代码以自动执行任务。

利用OPUS集成生成家具和环境程序资产。

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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