Skip to content
Back to search

houdini-mcp

HoudiniMCP – Connect Houdini to Claude via Model Context Protocol

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/capoomgit--houdini-mcp/badge.svg)](/listings/capoomgit--houdini-mcp)

HTML

<a href="/listings/capoomgit--houdini-mcp"><img src="/api/listings/capoomgit--houdini-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 158 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # HoudiniMCP – Connect Houdini to Claude via Model Context Protocol
  2. **HoudiniMCP** allows you to control **SideFX Houdini** from **Claude** using the **Model Context Protocol (MCP)**. It consists of:
  3. 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.).
  4. 2. An **MCP bridge script** you run via **uv** (or system Python) that communicates via **std**in/**std**out with Claude and **TCP** with Houdini.
  5. Below are the complete instructions for setting up Houdini, uv, and Claude Desktop.
  6. ---
  7. ## Table of Contents
  8. 1. [Requirements](#requirements)
  9. 2. [Houdini MCP Plugin Installation](#houdini-mcp-plugin-installation)
  10. 1. [Folder Layout](#folder-layout)
  11. 2. [Shelf Tool (Optional)](#shelf-tool-optional)
  12. 3. [Packages Integration (Optional)](#packages-integration-optional)
  13. 3. [Installing the `mcp` Python Package](#installing-the-mcp-python-package)
  14. 1. [Using uv on Windows](#using-uv-on-windows)
  15. 2. [Using pip Directly](#using-pip-directly)
  16. 4. [Bridging Script and Claude for Desktop](#bridging-script-and-claude-for-desktop)
  17. 1. [The Bridging Script](#the-bridging-script)
  18. 2. [Telling Claude Desktop to Use Your Script](#telling-claude-desktop-to-use-your-script)
  19. 5. [Testing & Usage](#testing--usage)
  20. 6. [Troubleshooting](#troubleshooting)
  21. ---
  22. ## Requirements
  23. - **SideFX Houdini**
  24. - **uv**
  25. - **Claude Desktop** (latest version)
  26. ---
  27. ## 1. Houdini MCP Plugin Installation
  28. ### 1.1 Folder Layout
  29. Create a folder in your Houdini scripts directory:
  30. C:/Users/YourUserName/Documents/houdini19.5/scripts/python/houdinimcp/
  31. Inside **`houdinimcp/`**, place:
  32. - **`__init__.py`** – handles plugin initialization (start/stop server)
  33. - **`server.py`** – defines the `HoudiniMCPServer` (listening on port `9876`)
  34. - **`houdini_mcp_server.py`** – optional bridging script (some prefer a separate location)
  35. - **`pyproject.toml`**
  36. *(If you prefer, `houdini_mcp_server.py` can live elsewhere. As long as you know its path for running with `uv`.)*
  37. ### 1.2 Shelf Tool
  38. create a **Shelf Tool** to toggle the server in Houdini:
  39. 1. **Right-click** a shelf → **"New Shelf..."**
  40. Name it "MCP" or something similar
  41. 2. **Right-click** again → **"New Tool..."**
  42. Name: "Toggle MCP Server"
  43. Label: "MCP"
  44. 3. Under **Script**, insert something like:
  45. ```python
  46. import hou
  47. import houdinimcp
  48. if hasattr(hou.session, "houdinimcp_server") and hou.session.houdinimcp_server:
  49. houdinimcp.stop_server()
  50. hou.ui.displayMessage("Houdini MCP Server stopped")
  51. else:
  52. houdinimcp.start_server()
  53. hou.ui.displayMessage("Houdini MCP Server started on localhost:9876")
  54. ```
  55. ### 1.3 Packages Integration
  56. 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/):
  57. ```json
  58. {
  59. "path": "$HOME/houdini19.5/scripts/python/houdinimcp",
  60. "load_package_once": true,
  61. "version": "0.1",
  62. "env": [
  63. {
  64. "PYTHONPATH": "$PYTHONPATH;$HOME/houdini19.5/scripts/python"
  65. }
  66. ]
  67. }
  68. ```
  69. ### 2 Using uv on Windows
  70. ```powershell
  71. # 1) Install uv
  72. powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  73. # 2) add uv to your PATH (depends on the user instructions) from cmd
  74. set Path=C:\Users\<YourUserName>\.local\bin;%Path%
  75. # 3) In a uv project or the plugin directory
  76. cd C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/
  77. uv add "mcp[cli]"
  78. # 4) Verify
  79. uv run python -c "import mcp.server.fastmcp; print('MCP is installed!')"
  80. ```
  81. ### 3 Telling Claude for Desktop to Use Your Script
  82. Go to File > Settings > Developer > Edit Config >
  83. Open or create:
  84. claude_desktop_config.json
  85. Add an entry:
  86. ```json
  87. {
  88. "mcpServers": {
  89. "houdini": {
  90. "command": "uv",
  91. "args": [
  92. "run",
  93. "python",
  94. "C:/Users/<YourUserName>/Documents/houdini19.5/scripts/python/houdinimcp/houdini_mcp_server.py"
  95. ]
  96. }
  97. }
  98. }
  99. ```
  100. if uv run was successful and claude failed to load mcp, make sure claude is using the same python version, use:
  101. ```cmd
  102. python -c "import sys; print(sys.executable)"
  103. ```
  104. to find python, and replace "python" with the path you got.
  105. ### 4 Use Cursor
  106. Go to Settings > MCP > add new MCP server
  107. add the same entry in claude_desktop_config.json
  108. you might need to stop claude and restart houdini and the server
  109. ### 5 OPUS integration
  110. OPUS provide a large set of furniture and environmental procedural assets.
  111. you will need a Rapid API key to log in. Create an account at: [RapidAPI](https://rapidapi.com/)
  112. Subscribe to OPUS API at: [OPUS API Subscribe](https://rapidapi.com/genel-gi78OM1rB/api/opus5/pricing)
  113. Get your Rapid API key at [OPUS API](https://rapidapi.com/genel-gi78OM1rB/api/opus5)
  114. copy `urls.env.example` to `urls.env` and add your key (the file is gitignored).
  115. OPUS integration is optional — without a key the server still starts, only the OPUS tools are disabled.
  116. ### 6 Acknowledgement
  117. Houdini-MCP was built following [blender-mcp](https://github.com/ahujasid/blender-mcp). We thank them for the contribution.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.