TouchDesigner MCP Server

What does “TouchDesigner” MCP Server do?

The TouchDesigner MCP Server is an implementation of the Model Context Protocol tailored for TouchDesigner, a visual development platform. This server acts as a bridge, allowing AI assistants to interact with and control TouchDesigner projects programmatically. Its main purpose is to enable AI-driven workflows, such as automating project operations, querying project states, or manipulating visual elements inside TouchDesigner, thereby enhancing creative coding and visual development processes with external AI capabilities. By exposing TouchDesigner functionalities through MCP, it empowers developers and artists to integrate AI agents with real-time graphics, generative art, and interactive installations, streamlining development and creative automation.

List of Prompts

No information found regarding prompt templates in the provided repository.

List of Resources

No explicit resource definitions found in the provided repository.

List of Tools

No details about specific tools found in server.py or equivalent entry file in the provided repository.

Use Cases of this MCP Server

• AI-controlled Visual Programming
  Allow AI agents to automate or generate content within TouchDesigner projects, such as procedural graphics, generative art, or visual effects.
• Interactive Installations
  Enable real-time control of TouchDesigner-based installations or performances through AI-driven instructions or adjustments.
• Remote Project Management
  Facilitate querying and modifying project state or parameters from external applications or AI agents, supporting collaborative or remote workflows.
• Integration with External Data
  Automate the ingestion and visualization of data streams (e.g., sensor inputs, web APIs) in TouchDesigner via AI-driven logic.
• Creative Coding Automation
  Accelerate prototyping by letting AI agents script or manipulate TouchDesigner networks for rapid creative exploration.

How to set it up

Windsurf

1. Ensure Node.js is installed.
2. Locate the configuration file for MCP servers in Windsurf.
3. Add the TouchDesigner MCP Server using the following JSON snippet:

   {
     "mcpServers": {
       "touchdesigner-mcp": {
         "command": "npx",
         "args": ["touchdesigner-mcp-server@latest"]
       }
     }
   }
   

4. Save the configuration and restart Windsurf.
5. Verify the setup by checking that the TouchDesigner MCP Server is running.

Claude

1. Install Node.js if necessary.
2. Open Claude’s MCP server configuration file.
3. Insert or update the MCP server entry:

   {
     "mcpServers": {
       "touchdesigner-mcp": {
         "command": "npx",
         "args": ["touchdesigner-mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Claude.
5. Confirm server availability in the Claude interface.

Cursor

1. Confirm Node.js is present.
2. Navigate to Cursor’s MCP configuration settings.
3. Add the server via:

   {
     "mcpServers": {
       "touchdesigner-mcp": {
         "command": "npx",
         "args": ["touchdesigner-mcp-server@latest"]
       }
     }
   }
   

4. Save changes and restart Cursor.
5. Check that the TouchDesigner MCP Server appears as an available MCP.

Cline

1. Install Node.js.
2. Open the relevant MCP server configuration file in Cline.
3. Add JSON configuration:

   {
     "mcpServers": {
       "touchdesigner-mcp": {
         "command": "npx",
         "args": ["touchdesigner-mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Cline.
5. Validate the MCP server setup.

Securing API Keys

To securely manage API keys, use environment variables within your configuration. Example:

{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": ["touchdesigner-mcp-server@latest"],
      "env": {
        "API_KEY": "${TOUCHDESIGNER_API_KEY}"
      },
      "inputs": {
        "projectFile": "path/to/your/project.toe"
      }
    }
  }
}

Replace "API_KEY" and "projectFile" as required for your environment.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "touchdesigner-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change "touchdesigner-mcp" to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Our opinion

Based on the available documentation and code, the TouchDesigner MCP server provides a useful bridge for AI integration with TouchDesigner, primarily targeting creative coding and automation. However, the lack of documented prompts, tools, and resource definitions limits its immediate out-of-the-box utility for advanced LLM workflows. The project is open-source (MIT), has community interest, and basic setup instructions are straightforward.

Score:
Given the lack of detailed MCP-specific features but presence of core setup and open-source status, we rate this MCP server as a 4/10 for general utility and completeness as an MCP server.

MCP Score