HoudiniMCP позволяет управлять SideFX Houdini из Claude с помощью протокола Model Context Protocol (MCP). Он состоит из:

1. Плагин Houdini (пакет на Python), который прослушивается на локальном порте (по умолчанию [localhost:9876) и обрабатывает команды (создание и модификацию узлов, выполнение кода и т.д.).
2. Скрипт моста *MCP, который вы запускаете через uv (или системный Python), который общается через stdin/stdout с Клодом и TCP с Houdini.

Ниже приведены полные инструкции по настройке Houdini, uv и Claude Desktop.

---

Содержание

1. Требования
2. Установка плагинов Houdini MCP
3. Оформление папок
4. Полочный инструмент (опционально)
5. Интеграция пакетов (необязательно)
6. Установка пакета Python mcp
7. Использование UV в Windows
8. Использование PIP напрямую
9. Мост скрипта и Claude для рабочего стола
10. Связующий сценарий
11. Сказать Claude Desktop использовать ваш скрипт
12. Тестирование и использование
13. Устранение неполадок

---

Требования

• SideFX Houdini
• uv
• 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/):

{