NousResearch/hermes-plugin-touchdesigner

NousResearch/hermes-plugin-touchdesigner

Description: Hermes Agent plugin: drive TouchDesigner via the twozero MCP server, with the touchdesigner-mcp skill bundled (Agent Plugins v1)

Language: Shell

License: MIT

Stars: 2

Forks: 1

Open issues: 0

Created: 2026-09-12T07:06:48Z

Pushed: 2026-09-12T07:06:51Z

Default branch: main

Fork: no

Archived: no

README:

hermes-plugin-touchdesigner

Drive a live TouchDesigner session from Hermes Agent through 404.zero's free twozero plugin, which embeds an MCP server inside the running TouchDesigner process (Streamable HTTP on 127.0.0.1:40404).

This is a portable Agent Plugins v1 package. It ships two things in one install:

• mcp.json — the twozero MCP server entry (td), registered for every

session while the plugin is enabled. No mcp_servers edits in config.yaml.

• skills/touchdesigner-mcp/ — the workflow skill: critical rules, discovery

steps, 20+ reference files (operators, GLSL, audio-reactive, instancing, pitfalls), and a scripts/setup.sh health check.

Install

hermes plugins install touchdesigner # catalog name
hermes plugins enable td # manifest name (kept short: see below)

Then, once per machine, inside TouchDesigner (2025.32280+, Windows/macOS):

1. Download 2. Drag twozero.tox into the TD network editor and click Install. 3. twozero icon → Settings → mcp → "auto start MCP" → Yes.

Start TD first, then a new Hermes session. The skill is available as agent-plugin-td-:touchdesigner-mcp via skill_view (skills_list shows the exact name); health check:

curl -s http://127.0.0.1:40404/mcp

Why the manifest name is td

Hermes registers portable MCP tools as mcp__agent_plugin______. twozero's longest tool name (td_screen_point_to_global) plus a touchdesigner namespace lands at 71 characters, past the 64-character function-name cap on OpenAI-compatible and Bedrock wire formats. td keeps every tool name at or under 60.

Security notes

• td_execute_python runs arbitrary Python inside TouchDesigner with no

sandbox — the same trust level as the terminal tool. The hub is localhost-only and unauthenticated.

• All 36 twozero tools register. The desktop input-automation tools

(td_input_*, td_click_screen_point, td_get_screen_screenshot, ...) and admin tools (td_project_quit, td_test_session — which exports transcripts to the vendor hub) are documented in the skill as opt-in: the agent is told to use them only on explicit request.

• Nothing in this package phones home. The only network access is the local

MCP endpoint and the optional twozero.tox download in setup.sh.

Migrating from the bundled skill

Earlier Hermes versions shipped touchdesigner-mcp as an optional skill whose setup.sh wrote a twozero_td entry into mcp_servers. Remove that entry (or a touchdesigner one written by hermes mcp install) so the server is not loaded twice.

Credits

Skill authored by @kshitijk4poor; twozero by 404.zero. MIT.