Houdini MCP

Model Context Protocol (MCP) サーバーで、Claude、Cursor、Antigravity、Codecs などの AI アシスタントを、起動中の Houdini Indie/FX セッションにシームレスに直接接続します。

これにより、あなたの AI はテクニカルディレクター（TD）として直接動作し、ノードの作成、ネットワークの配線、シーンデータの取得、物理シミュレーション、パラメータのリアルタイム変更が可能になります。

🚀 主な機能

• 20+ 組み込みツール: パラメータの読み取り、ノードの作成、VOP/SOP の配線、エラーの取得、.hip ファイルの保存など。

• 高度な Python/HScript 実行: AI が Houdini オブジェクトモデル（hou）に対して生の Python を実行できるようにするための抜け道（エスケープハッチ）を提供します。

• 完全ローカル: stdio と 127.0.0.1 で通信します。独自のシーンデータがあなたのマシンの外に送信されることはありません。

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 のコマンドを待ち受けるように指示する必要があります。方法は 2 つあります。

オプション 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 Settings > 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 ブロックを追加します。

📝 4. AI で試す例のプロンプト

接続が完了したら、AI に次のように尋ねてみてください：

• "現在開いている Houdini シーンのフレームレンジは何ですか？"

• "ボックスとチューブからプロシージャルな家を作成し、ブーリアン演算で結合して、RBD bullet solver にドロップしてください。"

• "現在クッキングエラーが発生しているネットワーク内のすべてのノードを見つけて、エラー内容を教えてください。"

• "/obj/geo1/sphere1 にあるスフィアを 5 倍の大きさにしてください。"

FastMCP と RPyC で構築されました。