houdini MCP Server

Use This MCP server To

Create and modify 3D objects in Houdini via AI commands Apply and adjust materials and colors on 3D models Inspect and retrieve detailed scene information programmatically Execute custom Python scripts inside Houdini remotely Trigger rendering processes directly from AI prompts Enable interactive AI-driven 3D scene creation and editing Automate repetitive modeling tasks using AI instructions

README

HoudiniMCP - Houdini Model Context Protocol Integration

HoudiniMCP connects Houdini to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Houdini. This integration enables prompt-assisted 3D modeling, scene creation, and manipulation within Houdini.

Features

Two-way communication: Connect Claude AI to Houdini through a socket-based server
Object manipulation: Create, modify, and delete 3D objects in Houdini
Material control: Apply and modify materials and colors
Scene inspection: Get detailed information about the current Houdini scene
Code execution: Run arbitrary Python code in Houdini from Claude
Rendering: Trigger renders directly from Claude

Components

The system consists of two main components:

Houdini Extension (houdini_mcp.py): A Python module that creates a socket server within Houdini to receive and execute commands
MCP Server (houdini_mcp_server.py): A Python server that implements the Model Context Protocol and connects to the Houdini extension

Installation

Prerequisites

Houdini 19.0 or newer
Python 3.10 or newer

Claude Desktop Integration

To connect Claude to Houdini:

Open Claude Desktop
Go to Claude > Settings > Developer > Edit Config
Update claude_desktop_config.json to include:

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

Edit the path to match your location for houdini_mcp_server.py

houdini-mcp FAQ

How does HoudiniMCP connect Claude AI to Houdini?

HoudiniMCP uses a socket-based server within Houdini to enable two-way communication with Claude AI, allowing direct command execution and scene manipulation.

Can I run custom Python code in Houdini through HoudiniMCP?

Yes, HoudiniMCP supports executing arbitrary Python scripts inside Houdini remotely via Claude AI commands.

Does HoudiniMCP support rendering control?

Yes, you can trigger rendering processes in Houdini directly from Claude AI through the MCP server.

Is HoudiniMCP limited to Claude AI?

While designed for Claude AI, the MCP protocol is provider-agnostic and can potentially support other LLMs like OpenAI's GPT-4 and Gemini with appropriate adapters.

What kind of scene information can HoudiniMCP provide?

It can retrieve detailed information about the current Houdini scene, including object properties, materials, and scene hierarchy.

How is HoudiniMCP deployed within Houdini?

It consists of a Python extension that runs a socket server inside Houdini and an MCP server component that manages communication with the AI.

Can HoudiniMCP automate repetitive 3D modeling tasks?

Yes, by leveraging AI commands, it can automate creation, modification, and other modeling workflows within Houdini.

What are the main components of HoudiniMCP?

The system includes a Houdini Python extension for socket communication and an MCP server that interfaces with Claude AI.