# touchdesigner-mcp-server

Connects AI agents to TouchDesigner via WebServer DAT. Lets models create nodes, inspect parameters, and run Python scripts inside your project.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 600
- Author: 8beeeaaat
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/8beeeaaat/touchdesigner-mcp
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/touchdesigner-mcp-server

## What it does

This server bridges AI agents and TouchDesigner using a dedicated `mcp_webserver_base.tox` component. Agents can inspect the project hierarchy, create or delete nodes, update parameters, and grab rendered frames directly from TOP nodes. When built-in tools are not enough, it executes arbitrary Python scripts or calls specific node methods.

The server checks for errors and warnings across node trees, catching broken references and shader problems via `get_td_node_errors`. Compatibility depends on the component API version (minimum supported is 1.3.0) rather than the npm package version. Without TouchDesigner running and listening via WebServer DAT, connection attempts trigger `ECONNREFUSED` and get cached for 60 seconds before retrying.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "touchdesigner-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "touchdesigner-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "touchdesigner-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "touchdesigner-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add touchdesigner-mcp-server npx -y touchdesigner-mcp-server
```

## When to use it
- create and configure TouchDesigner nodes from chat prompts
- detect broken references and shader warnings across node trees
- run arbitrary Python scripts directly in a running project
- capture visual frames from TOP nodes for model inspection

## Example prompts
- Create a `moviefilein` node under `/project1` and set its file path
- Check for errors and warnings on `/project1/geo1` and its children
- Capture the current output image from `/project1/out1`

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [PartCAD](https://affpapa.org/en/nevibecode/mcp/partcad.md) — MCP server · ★ 509
- [Funplay Cocos MCP](https://affpapa.org/en/nevibecode/mcp/funplay-cocos-mcp.md) — MCP server · ★ 357
- [Unity MCP](https://affpapa.org/en/nevibecode/mcp/isuzu-shiranui-unity-mcp.md) — MCP server · ★ 335

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md