Houdini MCP

Name: Houdini MCP
Author: JTCHE

ローカル

github.com/JTCHEメディア・デザイン131 日前に更新

リポジトリ

Houdini MCP について

Houdini MCPは、SideFX Houdiniのシーン確認、編集、実行、ドキュメント機能をClaudeやCodex、Geminiなどのエージェントに接続します。ビューポート画像とオフライン文書に対応し、Houdiniが開いていない場合はヘッドレスセッションを起動できます。

主な機能

01シーンノードの確認と編集
02cook、レンダー、PDGの実行
03ビューポートやフリップブックの撮影
04Python、HScriptの実行とVEX検査
05ローカルのHoudini文書の参照
06ノードネットワークの一括構築

活用シーン

01エージェント経由でシーンを確認・変更
02シーンを実行してレンダー結果を確認
03ビューポート画像を使ったフィードバック
04導入済みHoudiniの文書を検索

MCP 対応

MCPサーバーは、Houdiniのシーン、編集、実行、撮影、コード、文書に関するツールを公開します。Houdiniとはローカルで通信し、ヘッドレスのhythonも起動できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "jtche-houdini": {
      "command": "uvx",
      "args": [
        "houdini-mcp-server"
      ]
    }
  }
}

起動コマンドuvx houdini-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypihoudini-mcp-server0.8.1stdio

ツール

掲載時のツール一覧 · 4 日前に更新

パラメーター	型	必須	説明
operations	array	はい	順番に実行するステップです。各項目は {"tool": "<tool name>", "params": {...}} の形式で、各ツールが必要とする引数を指定します。このサーバーの batch 以外の任意のツールを指定できます。

詳細

Houdini MCP

SideFX HoudiniをClaude、Codex、Gemini、Cursor、opencode、またはpiに接続します。

このMCPは、選択したエージェントでMarkdown形式の完全なドキュメントとビューポートのスクリーンショットを利用できるようにし、効果的なフィードバックループと自律的なワークフローを実現します。

インストール

Windows

powershell -c "irm https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.bat -OutFile bootstrap.bat; .\bootstrap.bat"

macOS / Linux

curl -sSL https://raw.githubusercontent.com/JTCHE/houdini-mcp/main/bootstrap.sh | bash

uv tool install houdini-mcp-server && houdinimcp-install

インストーラーはプラグインをHoudiniに、サーバーを選択したAIクライアントに追加します。両方を再起動してください。
piでは、さらにpi install npm:pi-mcp-adapterも必要です。

Claudeプラグイン

このリポジトリはClaudeプラグインでもあり、お使いのコンピューター上のClaude CodeとCoworkで利用できます。uvが必要です。このプラグインは、セットアップなしでヘッドレスのHoudiniを起動します。起動中のHoudiniに接続するには、Claudeにhoudini-setupスキルを実行するよう依頼してください。

プラグインが実行する内容

uv run --frozenはプラグインフォルダー内のuv.lockから環境を構築し、このリポジトリのMCPサーバーを起動します。
サーバーはlocalhostのみでHoudiniと通信します。Houdiniのインストール先からhythonを起動し、リクエストに応じてhoudiniも起動します。また、フリップブック動画のエンコードにはffmpegを起動します。
docsはhoudinimd-docsを使い、Houdiniのインストール先からドキュメントを読み取ります。ネットワーク経由でデータを送信することはありません。
houdini-setupは、承認後にHoudiniの設定フォルダーへHoudiniMCPパッケージを書き込みます。
リモートサービスにデータを送信するツールはありません。executeは、Claudeが作成した任意のPythonをHoudiniセッションで実行します。

## ツール


読み取り	`scene_overview` `node_inspect` `geometry_inspect` `stage_inspect` `select` `console`
編集	`node_edit` `parm_set` `connect` `hda` `batch`
実行	`cook` `render` `pdg` `playbar` `scene_file`
表示	`capture`：ビューポート、カメラ、4 つのビュー、またはフリップブック
コード	`execute`：Python、HScript、式、VEX のチェック
ドキュメント	`docs`：ビルドに対応する Houdini のドキュメント。オフラインで利用でき、houdinimd-docs から入手できます
セッション	`session`：ステータス。Houdini をヘッドレスまたはウィンドウ付きで起動します

Houdini が起動していませんか？サーバーがヘッドレスの hython を起動します。

batch は 1 回の呼び出しでネットワーク全体を構築します。処理はすべて成功するか、すべて失敗するかのどちらかです。ステップが失敗すると、それ以前のステップは取り消されます。構築が成功すると、クックされたポイント数とプリミティブ数、およびエラーのあるノードが返されます。

Warning: execute は Houdini で任意の Python を実行します。作業内容を保存してください。

トラブルシューティング

問題	対処方法
ブリッジが接続できる Houdini がありません	Houdini を起動するか、HoudiniMCP シェルフの Toggle MCP Server をクリックします。
HoudiniMCP シェルフがありません	Houdini を再起動します。`houdinimcp-install --list` でプラグインのインストール先を確認できます。
Git Bash から起動した Houdini にプラグインがありません	Git Bash は `HOME` を設定します。ユーザー変数 `HOUDINI_USER_PREF_DIR` を `%USERPROFILE%\Documents\houdini__HVER__` に設定します。
`capture` でビューポートがないと表示されます	セッションはヘッドレスです。`action="start_gui"` を指定して `session` を呼び出します。
固定ポートが必要です	Houdini とブリッジの両方で `HOUDINIMCP_PORT` を設定します。設定しない場合、プラグインはオペレーティングシステムから空きポートを取得し、そのポートをブリッジに通知します。

エージェントとスクリプト向け

ターミナルを使用しない場合、インストーラーは何も質問せず、デフォルト値を使用します。

houdinimcp-install --list          # Houdini installs and clients found, as JSON
houdinimcp-install --yes --json    # newest Houdini, every client found; JSON report
houdinimcp-install --houdini-version 22.0 --harness claude-code --yes
houdinimcp-install --dry-run --yes # change nothing
houdinimcp-install --uninstall     # remove the plugin and every client entry

フラグ：--houdini-version none はプラグインをスキップし、--prefs-dir PATH は設定フォルダーを指定し、--harness none|all|KEY は（繰り返し指定可能）、--quiet-start は初回起動時のダイアログを停止します。ブートストラップスクリプトはすべてのフラグをそのまま渡します。

クライアントの手動セットアップ：引数なしで houdinimcp-bridge を実行します。 Claude Code の場合は claude mcp add --transport stdio houdini -- houdinimcp-bridge を実行します。

クローンから実行する場合：uv run python -m bridge.onboarding.install。

構成：src/houdinimcp/ はプラグインで、Houdini 内で localhost:9877 上に TCP サーバーを実行します。src/bridge/ は MCP サーバーとインストーラーです。メッセージは 4 バイトの長さプレフィックス付き JSON です。HOUDINIMCP_NO_HEADLESS=1 を設定すると、ヘッドレス起動を停止します。コードを変更する前に AGENTS.md を読んでください。

## クレジット

blender-mcp、 capoomgit/houdini-mcp、 eetumartola/houdini-mcp、 Houdini21MCP、 fxhoudinimcpを基に構築されています。MITライセンスです。

_{SideFXとは提携していません。HoudiniおよびSideFXは、SideFX Software Inc.の商標です。}

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Houdini MCP

Houdini MCP について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Houdini MCP

インストール

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？