Skip to content

touchbridge v0.3.0 - first public release

Choose a tag to compare

View all tags
@GaNotchVFX GaNotchVFX released this 24 Sep 04:36
· 3 commits to main since this release
v0.3.0
03b1d04

First public release of touchbridge: an MCP server for TouchDesigner built for live shows. It keeps working while TD is busy rendering, and it can't overwrite your project file.

Install

  1. Drag TouchBridge.tox (attached) into your TD project and save. Nothing else needs to be installed on the TD side.
  2. pipx install "git+https://github.com/GaNotchVFX/touchbridge@v0.3.0" (or pip install the attached wheel).
  3. Add {"mcpServers": {"touchbridge": {"command": "touchbridge-mcp"}}} to your MCP client config, then ask it to run bridge_status.

Highlights

  • No server inside TD. Commands are files in a queue. TD pulls them on a timer at its own pace, and a heartbeat tells "busy" from "dead".
  • Safe mode is on by default. Delete, script exec and in-place save are removed from the tool list, and batch and raw calls are gated the same way. Saves always go to a new numbered .toe, snapshots copy files and never Save As, and exports refuse to write over a .toe/.tox.
  • Checks by measuring: cook-time ranking, FPS/throttle, host-side GPU/VRAM, pixel statistics ("is the output black?"), a full-subtree error sweep, and a real round-trip time.
  • Compact YAML results. About 30% smaller than JSON with nothing lost, or 78–86% smaller with detail="summary".
  • 67 tools (64 in safe mode), 3 resources and 3 prompts; 154 tests that don't need TD.

Verified live on TouchDesigner 2025.32820 (Windows). Each call waits for TD's next tick, so back-to-back calls take about 0.5 s each. It isn't meant for 60 Hz control.

How it compares to the other TD MCP servers: docs/COMPARISON.md. Full list of changes: CHANGELOG.md.

Assets 6
Loading