Houdini MCPのインストール方法

HoudiniにAIエージェントが入ることで技術ブログの価値がほとんどなくなると思うので、この記事が最後になりそうですね。笑

実行環境はHoudiniとVS CodeのCodexまたはClaude拡張を使うことを想定しています。

OculairMedia MCPを使う

構成はこうなる。

[LLM (Claude / LM Studio / etc)]
        ↓ MCP
[OculairMedia MCP Server]
        ↓
[Houdini (Python API)]

Gitがインストール済みという前提。リポジトリを作る。

git clone https://github.com/oculairmedia/houdini-mcp.git

フォルダへ移動し、Pythonの依存をインストールする。

pip install -r requirements.txt

run_houdini_mcp.ps1を実行してOculairMedia MCP Serverを立ち上げる。（AIに.batファイルを作ってもらうといいかも）

Claude Codeの設定

C:\Users\<ユーザー>\.claude
にsettings.jsonを作成する。

{
  "mcpServers": {
    "houdini": {
      "type": "http",
      "url": "http://localhost:3055/mcp"
    }
  }
}

Claude Codeを再起動すると、Houdini MCP サーバーが使えるようになります。再起動後、/mcp コマンドで接続状態を確認できます。

Codexの設定

C:\Users\<ユーザー>\.codex
にある、config.tomlを開き、以下のコードを書き加える。

[mcp_servers.houdini]
url = "http://localhost:3055/mcp"
startup_timeout_sec = 20
tool_timeout_sec = 120
required = false

Codexを再起動すると、Houdini MCP サーバーが使えるようになります。再起動後、/mcp コマンドで接続状態を確認できます。

Houdiniでサーバーを立てる

Python Shellで以下を実行する。

import hrpyc; hrpyc.start_server(port=18811)

毎回は面倒なのでShelf Toolを作るとよい

Name:Start hrpyc
Label:Start hrpyc

ScriptタブにPythonを書く

import hrpyc
import hou

try:
    hrpyc.start_server(port=18811)
    hou.ui.setStatusMessage("hrpyc server started on port 18811", severity=hou.severityType.Message)
except Exception as e:
    hou.ui.setStatusMessage(f"hrpyc start failed: {e}", severity=hou.severityType.Warning)

毎回起動するときの手順

Houdiniを立ち上げる
Houdiniのサーバーを立ち上げる
OculairMedia MCP Serverを立ち上げる
VS Codeの拡張で通信を確認する

という流れになります。ちょっと面倒くさいですね。

非常に便利ですが、更新後の差分がわかりにくいところがちょっと怖いですね。とはいえ利便性を考えたら気にしなくてもいいのかもしれない・・。

お疲れ様でした！