Skip to content

touchdesigner-mcp-server - 2.2.0 Release

Latest

Choose a tag to compare

@github-actions github-actions released this 30 Oct 12:31
· 1 commit to main since this release
d3032d6

Downloads

Installation

For complete installation instructions, see the Installation Guide. 日本語

Quick Start (Claude Desktop)

  1. Download TouchDesigner Components and the MCP Bundle from the Downloads section above
  2. Extract touchdesigner-mcp-td.zip and import mcp_webserver_base.tox into your TouchDesigner project
  3. Double-click touchdesigner-mcp.mcpb to 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

  1. Download TouchDesigner Components from the Downloads section above
  2. Replace TouchDesigner components:
  3. Delete the existing touchdesigner-mcp-td folder from your system
  4. Delete old mcp_webserver_base node from your TouchDesigner project
  5. Extract and import the new mcp_webserver_base.tox to your TouchDesigner project
  6. 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.