tdmcp

Português

English

Português

English

Appearance

Codex + TouchDesigner ​

O tdmcp conecta o Codex CLI ao TouchDesigner pelo Model Context Protocol. Depois de conectado, você descreve um visual em linguagem natural dentro do Codex e ele monta a rede de operadores de verdade no seu projeto — depois confere se há erros e te mostra um preview.

Se você também usa Claude ou Cursor, a ideia é a mesma; esta página é o caminho específico do Codex. Para o quadro completo, veja Instalação.

O que você precisa ​

  • TouchDesigner — a edição gratuita (não comercial) serve.
  • Node.js 20+ — o Codex roda o servidor tdmcp como um processo node local via stdio.
  • O Codex CLI instalado e funcionando (codex --version).

Conecte o tdmcp ao Codex ​

Você pode registrar o tdmcp a partir do pacote npm publicado (sem clonar) ou de um build local. De qualquer forma, o Codex o inicia como um servidor MCP via stdio.

Deixe o Codex fazer por você

Cole isto no Codex e ele instala e conecta tudo sozinho, parando só na única linha do TouchDesigner:

text
Install and connect tdmcp for me by reading and following
https://raw.githubusercontent.com/Pantani/tdmcp/main/tdmcp-install-prompt.md
Do every step yourself; only stop when you need me to paste one line into TouchDesigner.

Opção A — pelo npm (sem clonar) ​

Adicione o tdmcp ao ~/.codex/config.toml (juntando a qualquer [mcp_servers.*] existente):

toml
[mcp_servers.tdmcp]
command = "npx"
args = ["-y", "@dpantani/tdmcp"]

Opção B — a partir de um build local ​

Clone e compile, depois aponte o Codex para dist/index.js:

bash
git clone https://github.com/Pantani/tdmcp.git
cd tdmcp
npm run setup   # instala, compila e imprime a linha exata para conectar

Depois rode codex mcp add tdmcp -- node <project-path>/dist/index.js (<project-path> é a pasta clonada — rode pwd nela), ou adicione ao ~/.codex/config.toml na mão:

toml
[mcp_servers.tdmcp]
command = "node"
args = ["<project-path>/dist/index.js"]

Reinicie sua sessão do Codex depois, para ele carregar o novo servidor.

Ligue a ponte no TouchDesigner ​

O tdmcp precisa de uma pequena ponte rodando dentro do TouchDesigner. Abra o Textport (Dialogs → Textport and DATs), cole esta única linha e aperte Enter:

python
import urllib.request; exec(urllib.request.urlopen("https://raw.githubusercontent.com/Pantani/tdmcp/main/td/bootstrap.py").read().decode())

Você deve ver [tdmcp] bridge running on port 9980. Este é o único passo que tem que acontecer dentro do TouchDesigner — veja Instalação para os detalhes e como remover depois.

Crie algo ​

Com o TouchDesigner aberto e a ponte ligada, peça ao Codex em linguagem natural:

"Crie uma galáxia de partículas reativa ao áudio e me mostre um preview."

Ele monta a rede, confere se há erros e devolve uma miniatura. Continue em linguagem natural — "deixa mais quente", "adiciona um rastro de feedback", "manda em tela cheia". Mais ideias nas receitas de prompt, e Seu primeiro visual percorre um do começo ao fim.

Não conecta? ​

  • Confirme que a ponte está ligada: curl http://127.0.0.1:9980/api/info deve devolver JSON.
  • Reinicie a sessão do Codex depois de editar o ~/.codex/config.toml — os servidores MCP são carregados no início.
  • A Solução de problemas completa cobre os casos comuns.

Para host/porta, variáveis de ambiente e o CLI do copiloto local, veja a referência do CLI (em inglês) e as variáveis de ambiente.