使用说明

项目简介

Houdini MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在连接 Claude AI 与 SideFX Houdini。通过此服务器，用户可以使用自然语言指令，让 Claude AI 控制 Houdini 进行 3D 建模、场景编辑、材质设置和渲染等操作。

主要功能点

连接 Claude AI 和 Houdini，实现双向通信。
在 Houdini 中创建、修改和删除 3D 对象。
控制对象材质和颜色。
获取 Houdini 场景信息和对象信息。
在 Houdini 中执行 Python 代码。
触发 Houdini 场景渲染，并将渲染结果返回给 Claude。

安装步骤

确保已安装 Houdini 19.0 或更高版本，以及 Python 3.10 或更高版本。
将 'houdini_mcp_server.py' 文件保存到本地目录，例如 'E:/code/houdini-mcp/'。
将 'houdini_mcp.py' 文件复制到 Houdini 首选项文件夹的 'python3.11libs/' 子文件夹中。

服务器配置

在 Claude Desktop 的配置 'claude_desktop_config.json' 文件中，添加以下 'mcpServers' 配置来注册 Houdini MCP 服务器：

{
    "mcpServers": {
        "houdini": {
            "command": "py",
            "args": [
                "E:/code/houdini-mcp/houdini_mcp_server.py"
            ]
        }
    }
}

'server name': 'houdini' (服务器名称，可以自定义)
'command': 'py' (启动服务器的命令，这里使用 Python 解释器)
'args': '["E:/code/houdini-mcp/houdini_mcp_server.py"]' (启动参数，指向 'houdini_mcp_server.py' 脚本的路径，请替换为实际路径)

基本使用方法

启动 Houdini，在 Houdini 的 Python Shell 中运行以下代码以启动 Houdini 扩展服务器：

import houdini_mcp
houdini_mcp.start_server()

启动 Claude Desktop，确保已配置 Houdini MCP 服务器。
在 Claude 中，可以使用自然语言指令，例如 "创建一个红色球体"、"渲染场景" 等，Claude 将调用 Houdini MCP 服务器控制 Houdini 完成相应操作。

关键词