HoudiniMCP는 **Model Context Protocol(MCP)**를 사용하여 Claude에서 SideFX Houdini를 제어할 수 있게 해줍니다. 구성은 다음과 같습니다:

1. 로컬 포트(기본 localhost:9876)를 듣고 노드 생성 및 수정, 코드 실행 등 명령을 처리하는 Houdini 플러그인(Python 패키지).
2. MCP 브리지 스크립트를 uv(또는 시스템 파이썬)로 실행하며, Claude에서는 stdin/stdout, Houdini에서는 TCP로 통신합니다.

아래는 Houdini, UV, Claude Desktop을 설정하는 완전한 안내입니다.

---

목차

1. 요구 사항
2. 후디니 MCP 플러그인 설치
3. 폴더 배치
4. 선반 도구 (선택 사항)
5. 패키지 통합 (선택 사항)
6. mcp Python 패키지 설치
7. Windows에서 UV 사용
8. pip 직접 사용
9. 데스크톱용 스크립트와 클로드 브리징
10. 브리징 스크립트
11. 클로드 데스크톱에 스크립트를 사용하도록 지시하기
12. 테스트 및 사용
13. 문제 해결

---

요구 사항

• 사이드FX 후디니
• 으우
• 클로드 데스크톱 (최신 버전)

---

1. Houdini MCP 플러그인 설치

1.1 폴더 배치

Houdini 스크립트 디렉터리에 폴더를 만드세요: C:/Users/YourUserName/Documents/houdini19.

HoudiniMCP – Connect Houdini to Claude via Model Context Protocol

HoudiniMCP allows you to control SideFX Houdini from Claude using the Model Context Protocol (MCP). It consists of:

1. A Houdini plugin (Python package) that listens on a local port (default localhost:9876) and handles commands (creating and modifying nodes, executing code, etc.).
2. An MCP bridge script you run via uv (or system Python) that communicates via stdin/stdout with Claude and TCP with Houdini.

Below are the complete instructions for setting up Houdini, uv, and Claude Desktop.

---

Table of Contents

1. Requirements
2. Houdini MCP Plugin Installation
   1. Folder Layout
   2. Shelf Tool (Optional)
   3. Packages Integration (Optional)
3. Installing the mcp Python Package
   1. Using uv on Windows
   2. Using pip Directly
4. Bridging Script and Claude for Desktop
   1. The Bridging Script
   2. Telling Claude Desktop to Use Your Script
5. Testing & Usage
6. Troubleshooting

---

Requirements

• SideFX Houdini
• uv
• Claude Desktop (latest version)

---

1. Houdini MCP Plugin Installation

1.1 Folder Layout

Create a folder in your Houdini scripts directory: C:/Users/YourUserName/Documents/houdini19.5/scripts/python/houdinimcp/

Inside houdinimcp/, place:

• __init__.py – handles plugin initialization (start/stop server)
• server.py – defines the HoudiniMCPServer (listening on port 9876)
• houdini_mcp_server.py – optional bridging script (some prefer a separate location)
• pyproject.toml

(If you prefer, houdini_mcp_server.py can live elsewhere. As long as you know its path for running with uv.)

1.2 Shelf Tool

create a Shelf Tool to toggle the server in Houdini:

1. Right-click a shelf → “New Shelf…”

Name it “MCP” or something similar

2. Right-click again → “New Tool…” Name: “Toggle MCP Server” Label: “MCP”

3. Under Script, insert something like:

   import hou
   import houdinimcp

   if hasattr(hou.session, "houdinimcp_server") and hou.session.houdinimcp_server:
       houdinimcp.stop_server()
       hou.ui.displayMessage("Houdini MCP Server stopped")
   else:
       houdinimcp.start_server()
       hou.ui.displayMessage("Houdini MCP Server started on localhost:9876")

1.3 Packages Integration

If you want Houdini to auto-load your plugin at startup, create a package file named houdinimcp.json in the Houdini packages folder (e.g. C:/Users/YourUserName/Documents/houdini19.5/packages/):

{