TouchDesigner

TouchDesigner MCP

This is an implementation of an MCP (Model Context Protocol) server for TouchDesigner. Its goal is to enable AI agents to control and operate TouchDesigner projects.

Overview

TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebServer DAT, enabling AI agents to:

• Create, modify, and delete nodes
• Query node properties and project structure
• Programmatically control TouchDesigner via Python scripts

Usage

Method 1: Using Claude Desktop and Desktop Extensions (Recommended)

1. Download Files
2. Set up TouchDesigner Components
3. Install the Desktop Extension
4. Connect to the Server

Method 2: Using npx

1. Set up TouchDesigner Components
2. Set up the MCP Server Configuration

Method 3: Using a Docker Image

1. Clone the repository
2. Build the Docker image
3. Install the API Server in Your TouchDesigner Project
4. Start the MCP server container

Verify Connection

If the MCP server is recognized, the setup is complete. If it's not recognized, try restarting your AI agent.

Directory Structure Requirements

Critical: When using any method, you must maintain the original directory structure.

MCP Server Features

This server enables AI agents to perform operations in TouchDesigner using the Model Context Protocol (MCP).

Tools

Tools allow AI agents to perform actions in TouchDesigner.

Prompts

Prompts provide instructions for AI agents to perform specific actions in TouchDesigner.

Resources

Not implemented.

For Developers## Quick Start for Development

1. Set up your environment.
2. Build the project.
3. Available commands.

Project Structure Overview# API Code Generation Workflow

This project uses OpenAPI-based code generation tools.

Contributing

We welcome your contributions!