Houdini MCP
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 服务器运行在外部。因此,我们需要安装这台桥接依赖。
克隆或下载此存储库。
双击
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 连接在后台运行,这样您无需手动操作。
进入你的 Houdini 偏好设置文件夹 (例如,
Documents/houdini21.0/或Documents/houdini19.5/)。打开或创建
scripts文件夹。在
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: 手动启动
如果您只想在你明确需要时才运行该连接:
打开 Houdini (Indie、FX 或 Core)。
转到 Windows > Python Shell(或按
Alt + Shift + P)。粘贴以下代码片段并按下 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.jsonMac:
~/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 中
打开 Cursor 设置 > Features > MCP Servers。
点击 + Add New MCP Server。
Name:
HoudiniType:
commandCommand:
"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…
This server cannot be deployed
Maintenance
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects Houdini to Claude AI through Model Context Protocol, enabling AI-assisted 3D modeling, scene creation, simulation setup, and rendering through natural language commands.58-
- AlicenseNot gradedqualityDmaintenanceEnables AI-assisted 3D content creation by allowing Claude Code to control SideFX Houdini directly, including creating nodes, setting parameters, executing HScript commands, and building complex procedural networks.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants and CLI tools to read and control Houdini scenes with a safety model that separates read and write operations.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Houdini by executing Python code, querying scene information, and creating nodes via the Model Context Protocol.2-