TouchDesigner

TouchDesigner

An MCP server for TouchDesigner, enabling interaction with TouchDesigner projects, nodes, and parameters.

139
Stars
13
Forks
19
Releases

Overview

TouchDesigner MCP implements the Model Context Protocol (MCP) server for TouchDesigner, enabling AI agents to control and operate TouchDesigner projects. It acts as a bridge between AI models and the TouchDesigner WebServer DAT, permitting automated creation, modification, and deletion of nodes; querying node properties and project structure; and programmatic control of TouchDesigner via Python scripts. The architecture splits responsibilities: a Node.js MCP server offering Tools, Prompts, and an OpenAPI HTTP client; and a TouchDesigner-side stack with the WebServer DAT (mcp_webserver_base.tox) and Python controllers/services that implement the business logic and expose the generated endpoints. The project relies on OpenAPI-based code generation to produce a Python server within TD and a TypeScript client for the Node.js server, with build steps described for webserver, handlers, and client. Deployment options include Claude Desktop MCP Bundle, npx, or Docker, with strict directory structure requirements to preserve relative paths to modules. Exposed tools include: create_td_node, delete_td_node, exec_node_method, execute_python_script, get_td_class_details, get_td_classes, get_td_info, get_td_node_parameters, get_td_nodes, update_td_node_parameters; prompts include: Search node, Node connection, Check node errors.

Details

Owner
8beeeaaat
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Tools

A set of actions the AI can perform in TouchDesigner through the MCP server, including creating, deleting, updating nodes, calling Python methods, executing scripts, and querying environment and node data (e.g., get_td_info, get_td_nodes, get_td_node_parameters, update_td_node_parameters, get_td_class_details, get_td_classes).

Prompts

Instruction templates to guide AI interactions, including fuzzy node search, node connection, and node error checks (Search node, Node connection, Check node errors).

Audience

AI agentsEnable AI agents to control TouchDesigner projects via MCP server (nodes, parameters, scripts).

Tags

TouchDesignerMCPWebServer DATAI agentsNode controlPython integrationOpenAPIDockerClaude Desktopmcp_webserver_base.toxTD modulestd_server