td-mcp 0.1.0

MCP server for controlling TouchDesigner from AI coding agents

td-mcp

MCP (Model Context Protocol) server for controlling TouchDesigner from AI coding agents like Claude Code and Codex CLI.

Setup

1. TouchDesigner Side

1. Create a WebServer DAT
2. Set Port to 9980
3. Paste the contents of td_bridge/webserver_callbacks.py into the WebServer DAT callbacks
4. Toggle Active ON

2. Agent Side

Claude Code (.mcp.json)

{
  "mcpServers": {
    "touchdesigner": {
      "command": "uvx",
      "args": ["td-mcp"],
      "env": {
        "TD_HOST": "127.0.0.1",
        "TD_PORT": "9980"
      }
    }
  }
}

Local Development (before PyPI publish)

{
  "mcpServers": {
    "touchdesigner": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/td-mcp", "python", "-m", "td_mcp"],
      "env": {
        "TD_HOST": "127.0.0.1",
        "TD_PORT": "9980"
      }
    }
  }
}

Codex CLI

codex mcp add touchdesigner \
  --env TD_HOST=127.0.0.1 \
  --env TD_PORT=9980 \
  -- uvx td-mcp

Tools

Tool	Description
td_get_root	Get project root path (call first)
td_create_op	Create an operator
td_delete_op	Delete an operator
td_list_ops	List child operators
td_get_op_info	Get operator info
td_set_params	Set parameters (batch)
td_get_params	Get parameters (with schema discovery)
td_connect	Connect operators
td_disconnect	Disconnect operators
td_find_empty_space	Find empty space in network editor
td_execute	Execute Python code in TD
td_get_screenshot	Capture TOP screenshot

Environment Variables

Variable	Default	Description
TD_HOST	127.0.0.1	TouchDesigner host
TD_PORT	9980	WebServer DAT port
TD_TIMEOUT	10.0	Request timeout (seconds)

Architecture

AI Agent → MCP Server (stdio) → HTTP Client → TouchDesigner WebServer DAT

Security Note

td_execute allows arbitrary Python execution inside TouchDesigner. Use only in trusted local environments.

License

MIT