touch-mcp

High-performance MCP server for TouchDesigner — live control via WebSocket from any MCP-compatible AI (Claude, etc.)

Claude/LLM ←── stdio (MCP) ──→ touch-mcp ←── WebSocket ──→ TouchDesigner (.tox)

---

| Feature | touch-mcp | 8beeeaaat | bottobot | |---|---|---|---| | Transport | WebSocket (persistent) | HTTP (per-request) | — | | Live control | Yes | Partial | No | | Batching | Yes (td_batch) | No | No | | Tools | 29 | 13 | — | | Workflow | Fully automated | Automated | Copy-paste | | .tox component | Yes | No | No |

touch-mcp maintains a persistent WebSocket connection to TouchDesigner so every tool call is a lightweight message over an already-open socket. The td_batch tool further reduces round-trips by bundling multiple operations into a single request — critical for building complex node networks in one shot.

---

1. Install touch-mcp

pip install touch-mcp

Or from source:

git clone https://github.com/yourusername/touch-mcp.git
cd touch-mcp
pip install -e ".[dev]"

2. Install the TouchDesigner bridge component

Open TouchDesigner (2024+), then drag TouchMCPBridge.tox from the td/ folder into your project. The component starts a WebSocket server on port 9980 automatically.

For instructions on building the .tox from source, see `td/BUILD_TOX.md`.

3. Configure your MCP client

See the configuration sections below, then start a conversation — touch-mcp connects to TouchDesigner on first use.

---

Add the following to your claude_desktop_config.json:

{
    "mcpServers": {
        "touchdesigner": {
            "command": "touch-mcp",
            "args": ["--td-port", "9980"]
        }
    }
}

The config file is located at:

• macOS: `~/Library/Application