Houdini MCP

AI 어시스턴트(예: Claude, Cursor, Antigravity, Codecs)를 실행 중인 Houdini Indie/FX 세션에 직접 연결해 주는 Model Context Protocol(MCP) 서버입니다.

이 서버를 통해 AI는 테크니컬 디렉터(TD)처럼 노드 생성, 네트워크 배선, 씬 데이터 조회, 물리 시뮬레이션, 파라미터 실시간 수정 등을 직접 수행할 수 있습니다.

🚀 기능

• 20개 이상의 내장 도구: 파라미터 읽기, 노드 생성, VOP/SOP 네트워크 배선, 에러 캡처, .hip 파일 저장 등.

• 고급 Python/HScript 실행: AI가 Houdini Object Model(hou)을 대상으로 원시 Python을 실행할 수 있는 탈출구를 제공합니다.

• 완전 로컬 환경: stdio와 127.0.0.1로 통신합니다. 독점적인 씬 데이터가 PC 밖으로 유출되지 않습니다.

Related MCP server: Houdini MCP Server

🛠️ 1. 설치

Houdini는 내부 Python 환경을 사용하지만, MCP 서버는 외부에서 실행됩니다. 브리지 의존성을 설치해야 합니다.

1. 이 저장소를 클론하거나 다운로드하세요.

2. 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 연결이 백그라운드에서 자동으로 실행되도록 구성하면, 매번 수동으로 실행할 필요가 없습니다.

1. Houdini 환경설정 폴더로 이동하세요. (예: Documents/houdini21.0/ 또는 Documents/houdini19.5/)

2. scripts 폴더를 열거나 생성하세요.

3. 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: 수동 시작

명시적으로 필요할 때만 연결을 실행하려면:

1. Houdini (Indie, FX 또는 Core)를 엽니다.

2. Windows > Python Shell로 가거나 Alt + Shift + P를 누릅니다.

3. 다음 코드를 붙여넣고 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.json

• Mac: ~/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 사용 시

1. Cursor 설정 > Features > MCP Servers로 이동합니다.

2. + Add New MCP Server를 클릭합니다.

3. 이름(Name): Houdini

4. 유형(Type): command

5. 명령(Command): "C:\path\to\-Houdini-s-MCP-\.venv\Scripts\python.exe" "C:\path\to\-Houdini-s-MCP-\houdini_mcp_server.py"

🔹 Antigravity 사용 시

~/.gemini/config/mcp_config.json을 열고 위 Claude Desktop 예제와 동일한 JSON 블록을 추가합니다.

📝 AI와 시도할 예제 프롬프트

연결이 완료되면 AI에게 다음과 같이 요청해 보세요:

• "현재 열린 Houdini 장면의 프레임 레인지는 무엇인가요?"

• "박스와 튜브로 절차적 하우스를 만들고, 두 오브젝트를 변경하고, RBD bullet solver에 넣어주세요."

• "네트워크에서 쿠징 오류가 있는 모든 노드를 찾아 무엇이 잘못됐는지 말해주세요."

• "/obj/geo1/sphere1에 있는 스피어를 5배로 키워주세요."

FastMCP 및 RPyC로 제작되었습니다.