# Embody — TouchDesigner MCP Server for Node Networks

> Embody is a TouchDesigner toolkit with an embedded MCP server (Envoy) so agents can build, wire, and debug live node networks from chat.

## Install

Merge the JSON below into your `.mcp.json`:

## Quick Use

```bash
echo 'Download the Embody .tox and drag it into TouchDesigner:'
echo 'https://github.com/dylanroscover/Embody/tree/main/release'
# Enable Envoy in TouchDesigner, then connect MCP host to:
echo 'http://localhost:9870/mcp'
```

## Intro

Embody is a TouchDesigner toolkit with an embedded MCP server (Envoy) so agents can build, wire, and debug live node networks from chat.

**Best for:** Creative coders who want agents to control a live TouchDesigner session

**Works with:** TouchDesigner project (.toe), Embody TOX, MCP hosts (Claude Code/Cursor/Windsurf)

**Setup time:** 6-15 minutes

### Key facts (verified)

- GitHub: 101 stars · 1 forks · pushed 2026-05-13.
- License: MIT · owner avatar + repo URL verified via GitHub API.
- README-verified entrypoint: `echo 'Download Embody TOX from https://github.com/dylanroscover/Embody/tree/main/release'`.

## Main

- Start with externalization: tag only the operators you care about so diffs stay clean and project open stays fast.

- Enable Envoy when you’re ready for agent control; it exposes MCP tools for creating operators, wiring networks, setting parameters, and debugging errors.

- Keep the MCP connection scoped to a repo/project root: Envoy can auto-generate `.mcp.json` when your project is in a git repo.

### Source-backed notes

- README Quick Start instructs downloading a release TOX and tagging operators via a keyboard shortcut to externalize.
- README states Envoy runs on localhost (default 9870) and can auto-create `.mcp.json` in the repo root.
- README includes an Envoy tools overview and links to a full tools reference in docs.

### FAQ

- **Is it an npm/pip package?**: No — README describes a TouchDesigner workflow using a .tox component.
- **Do I need git?**: No — git is optional, but README notes `.mcp.json` auto-generation assumes a repo root.
- **Is the MCP server remote?**: By default it’s local (`localhost`); treat it like local dev tooling and avoid exposing it publicly.

## Source & Thanks

> Source: https://github.com/dylanroscover/Embody
> License: MIT
> GitHub stars: 101 · forks: 1

---

<!-- ZH -->

## Quick Use

```bash
echo 'Download the Embody .tox and drag it into TouchDesigner:'
echo 'https://github.com/dylanroscover/Embody/tree/main/release'
# Enable Envoy in TouchDesigner, then connect MCP host to:
echo 'http://localhost:9870/mcp'
```

## Intro

Embody 是 TouchDesigner 工具集，内置 Envoy MCP 服务器：让 AI 直接对 TD 网络创建算子、连线、调参、排错。Envoy `localhost:9870` 并自动生成 `.mcp.json`；README 列出 47+ MCP 工具与快捷键。

**Best for:** 想让 agent 直接操控实时 TouchDesigner 会话的创意编程作者

**Works with:** TouchDesigner 工程（.toe）；Embody TOX；Claude Code/Cursor/Windsurf 等 MCP host

**Setup time:** 6-15 minutes

### Key facts (verified)

- GitHub：101 stars · 1 forks；最近更新 2026-05-13。
- 许可证：MIT；作者头像与仓库链接均已通过 GitHub API 复核。
- README 中核对过的入口命令：`echo 'Download Embody TOX from https://github.com/dylanroscover/Embody/tree/main/release'`。

## Main

- 先从外部化开始：只 tag 你关心的算子，保证 diff 干净、项目启动不被拖慢。

- 需要 agent 控制时再启用 Envoy：它提供创建算子、连线、设参、排错等 MCP 工具。

- 把 MCP 连接限制在项目根目录：当项目在 git repo 中时，Envoy 会自动生成 `.mcp.json`。

### Source-backed notes

- README 的 Quick Start 说明下载 release TOX 并通过快捷键给算子打 tag 完成外部化。
- README 写明 Envoy 默认运行在 localhost:9870，并可在 repo 根目录自动生成 `.mcp.json`。
- README 给出 Envoy 工具概览，并链接到文档中的完整 tools reference。

### FAQ

- **它是 npm/pip 包吗？**：不是。README 描述的是 TouchDesigner 里用 .tox 组件的工作流。
- **必须用 git 吗？**：不必，但 README 提到 `.mcp.json` 自动生成依赖 repo root；手动配置也可以。
- **MCP server 是远程的吗？**：默认是本机 `localhost`；把它当作本地开发工具，避免对公网暴露。

## Source & Thanks

> Source: https://github.com/dylanroscover/Embody
> License: MIT
> GitHub stars: 101 · forks: 1


---
Source: https://tokrepo.com/en/workflows/embody-touchdesigner-mcp-server-for-node-networks
Author: MCP Hub