HoudiniMCPは、Model Context Protocol(MCP)を用いてClaudeからSideFX Houdiniを制御できるようにします。構成は以下の通りです:

1. ローカルポート(デフォルトのlocalhost:9876])をリスニングし、コマンド(ノードの作成・変更、コード実行など)を処理するHoudiniプラグイン(Pythonパッケージ)。
2. MCPブリッジスクリプトをuv(またはシステムPython)で実行し、Claudeとはstdin/stdout、HoudiniではTCP**で通信します。

以下はHoudini、uv、Claude Desktopの設定手順を全部まとめました。

---

目次

1. 要件
2. Houdini MCPプラグインインストール
3. フォルダーの配置
4. 棚工具(オプション)
5. パッケージ統合(オプション)
6. mcp Python パッケージのインストール
7. WindowsでのUV使用について
8. pipを直接利用する
9. デスクトップ向けスクリプトとClaudeのブリッジ
10. ブリッジングスクリプト
11. Claude Desktopにスクリプトを使うよう指示する
12. テストと使用方法
13. トラブルシューティング

---

要件

• SideFX Houdini
• うーん
• Claude Desktop(最新バージョン)

---

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/):

{