8beeeaaat/touchdesigner-mcp

What it solves

This project provides a bridge between AI agents and TouchDesigner, allowing AI models to programmatically control, modify, and operate visual projects in real-time. It eliminates the manual effort of building nodes and wiring connections by enabling an AI to act as an operator.

How it works

It implements a Model Context Protocol (MCP) server that connects to the TouchDesigner WebServer DAT. This allows AI agents to send commands to TouchDesigner via a set of predefined tools and prompts, such as creating nodes, updating parameters, and executing Python scripts directly within the software.

Who it’s for

Visual artists, creative coders, and developers who use TouchDesigner for interactive installations or generative art and want to leverage AI agents to automate the project building process.

Highlights

• Node Management: Create, delete, and query the structure and properties of nodes.
• Python Integration: Execute arbitrary Python scripts and call node methods directly.
• ** uma a TOP image capture**: Ability to capture the current output of a TOP node as an image for the AI to see.
• Intelligent Prompts: Built-in prompts for fuzzy searching nodes and managing node connections.
• Version Compatibility: A robust system to ensure the MCP server and the TouchDesigner component stay in sync.