@higgsfield_org/touch-designer-mcp
v0.1.2
Published
Local MCP server for TouchDesigner with native project tools and offline skill guidance.
Keywords
Readme
Higgsfield TouchDesigner MCP
Local MCP server for TouchDesigner with native project tools and an offline touch-design-master skill. It combines the MIT-licensed touchdesigner-mcp-server 2.1.0 with a bundled token-protected TouchDesigner component.
Requirements
- Node.js 24 or later.
- TouchDesigner build 2025.33230 or later and a valid TouchDesigner key on the MCP host.
- A local desktop MCP client.
Installation
Install the package in a persistent directory because the TouchDesigner component loads adjacent Python modules:
tdDir="$HOME/.higgsfield/touch-designer-mcp"
npm install --prefix "$tdDir" @higgsfield_org/touch-designer-mcp
node "$tdDir/node_modules/@higgsfield_org/touch-designer-mcp/dist/cli.js" setupsetup creates a private token and prints a Python Textport command. Run that command in TouchDesigner for each project that needs MCP access. It loads the bundled component and binds its Web Server DAT to 127.0.0.1:9981. Save the .toe project yourself if you want that component to persist.
After running the Textport command, check the live connection and print a Codex entry:
node "$tdDir/node_modules/@higgsfield_org/touch-designer-mcp/dist/cli.js" doctor
node "$tdDir/node_modules/@higgsfield_org/touch-designer-mcp/dist/cli.js" config --format tomlUse config --format json for another MCP client. Register the printed absolute command and arguments, then reconnect. The stdio executable is fnf-touch-designer-mcp.
Tools
Call get_td_info to verify the native connection. td_get_skill reads bundled guidance even when TouchDesigner is closed. The native tool catalog includes execute_python_script; use it only with projects and scripts you trust.
Troubleshooting and limits
The component requires the private token stored under ~/.higgsfield/touch-designer-mcp/token. Keep port 9981 bound to loopback; do not expose it to a network. The package does not include Workshop preset execution. Attribution and adaptation details are in the installed UPSTREAM.md and UPSTREAM_LICENSE files.
