Repository navigation
Downloads
- TouchDesigner Components: touchdesigner-mcp-td.zip
- MCP Bundle (.mcpb): touchdesigner-mcp.mcpb
Installation
For complete installation instructions, see the Installation Guide. 日本語
Quick Start (Claude Desktop)
- Download
TouchDesigner Componentsand theMCP Bundlefrom the Downloads section above - Extract
touchdesigner-mcp-td.zipand importmcp_webserver_base.toxinto your TouchDesigner project - Double-click
touchdesigner-mcp.mcpbto install in Claude Desktop
Quick Start (Claude Code)
This repository is also a Claude Code plugin marketplace. The touchdesigner plugin installs and preconfigures this server for you:
claude plugin marketplace add 8beeeaaat/touchdesigner-mcp
claude plugin install touchdesigner@touchdesigner-mcp
Then run /touchdesigner:setup to verify the connection, or /touchdesigner:launch to start TouchDesigner with the component already imported. /touchdesigner:launch downloads the TouchDesigner Components itself; for any other route, import them from the Downloads section above first.
Quick Start (Codex)
Install the ready-to-use plugin from this repository's Codex marketplace; no manual npm build is needed:
codex plugin marketplace add 8beeeaaat/touchdesigner-mcp
codex plugin add touchdesigner@touchdesigner-openai
Requires the Codex CLI — a separate terminal tool that does not ship with the ChatGPT desktop app — plus Node.js; Codex starts the MCP server automatically. Import the TouchDesigner Components from the Downloads section above, then ask Codex to check the TouchDesigner connection or launch TouchDesigner. See the OpenAI plugin guide for configuration and ChatGPT connections.
Other AI Agents
See the Installation Guide 日本語 for:
- Docker deployment
- Developer setup
For Updates from Previous Versions
- Download
TouchDesigner Componentsfrom the Downloads section above - Replace TouchDesigner components:
- Delete the existing touchdesigner-mcp-td folder from your system
- Delete old mcp_webserver_base node from your TouchDesigner project
- Extract and import the new mcp_webserver_base.tox to your TouchDesigner project
- Restart TouchDesigner and the MCP client (e.g., Claude Desktop)
For more details, see: https://github.com/8beeeaaat/touchdesigner-mcp#troubleshooting-version-compatibility
Changes
See CHANGELOG.md for a detailed history of changes.