Variáveis de ambiente

Toda a configuração é feita por variáveis de ambiente (sem arquivo de config), então funciona de forma limpa em CI, Docker e na config do cliente MCP. Toda variável é opcional e tem um padrão sensato. Defina-as na config de servidor do seu cliente MCP (o bloco env), no seu shell, ou nas configurações da extensão do Claude Desktop.

Servidor

Variável	Padrão	Descrição
TDMCP_TD_HOST	127.0.0.1	Host da ponte do TouchDesigner.
TDMCP_TD_PORT	9980	Porta do Web Server DAT.
TDMCP_TRANSPORT	stdio	Transporte MCP: stdio (padrão) ou http (Streamable HTTP).
TDMCP_HTTP_PORT	3939	Porta do transporte HTTP (quando TDMCP_TRANSPORT=http).
TDMCP_EVENTS	on	Assina os eventos por WebSocket do TD e os encaminha como notificações de log do MCP (on/off).
TDMCP_RAW_PYTHON	on	Se expõe as duas tools de escape em Python cru (execute_python_script, exec_node_method). Defina como off para trancá-las em configurações restritas. Isso remove só essas duas tools de código escrito pelo cliente — muitas tools de mais alto nível ainda enviam o próprio Python templado à ponte, então off não significa "nenhum código roda no TD". Para realmente desativar a execução de código, defina TDMCP_BRIDGE_ALLOW_EXEC=0 no ambiente do TouchDesigner (abaixo).
TDMCP_BRIDGE_TOKEN	(não definido)	Token bearer compartilhado opcional. Quando definido, o servidor o envia e a ponte o exige — defina o mesmo valor no ambiente do TouchDesigner para ligar a autenticação.
TDMCP_LOG_LEVEL	info	debug / info / warn / error / silent (registrado no stderr).
TDMCP_REQUEST_TIMEOUT_MS	10000	Timeout por requisição à ponte, em milissegundos.
TDMCP_VAULT_PATH	(não definido)	Caminho absoluto para um vault do Obsidian (uma pasta de notas Markdown). Habilita as tools de vault (em inglês); um ~/ inicial é expandido. Deixe sem definir para desabilitá-las.

Copiloto local (tdmcp chat)

Estas configuram o copiloto LLM local (em inglês).

Variável	Padrão	Descrição
TDMCP_LLM_BASE_URL	http://127.0.0.1:11434/v1	Endpoint de chat compatível com OpenAI. Por padrão aponta para um Ollama local; aponte para LM Studio, uma GPU na nuvem ou uma API paga.
TDMCP_LLM_MODEL	qwen2.5:3b	Id do modelo que o copiloto pede (precisa estar baixado no backend, ex.: ollama pull qwen2.5:3b). Suba para qwen2.5:7b para mais folga.
TDMCP_LLM_API_KEY	(não definido)	Token bearer opcional para o endpoint do LLM (ignorado pelo Ollama local; necessário para APIs pagas/na nuvem).
TDMCP_CHAT_PORT	4141	Porta de loopback em que a UI web do tdmcp chat escuta.

Lado do TouchDesigner

Defina estas no ambiente do TouchDesigner (não no do servidor) para defesa em profundidade — elas são impostas do lado da ponte, mesmo para chamadores diretos na rede. Veja Segurança.

Variável	Padrão	Descrição
TDMCP_BRIDGE_ALLOW_EXEC	1	Defina como 0/false/off para a ponte recusar os endpoints de código arbitrário (/api/exec, method de nó). Os endpoints estruturados continuam funcionando.
TDMCP_BRIDGE_TOKEN	(não definido)	Token bearer compartilhado; precisa bater com o valor do servidor para autorizar as requisições.

Exemplo: config do cliente MCP

{
  "mcpServers": {
    "tdmcp": {
      "command": "node",
      "args": ["/abs/path/to/tdmcp/dist/index.js"],
      "env": {
        "TDMCP_TD_PORT": "9980",
        "TDMCP_VAULT_PATH": "~/Documents/MyVault"
      }
    }
  }
}