TouchDesigner MCP

Esta es una implementación de un servidor MCP (Protocolo de Contexto de Modelo) para TouchDesigner. El objetivo es permitir que los agentes de IA controlen y operen proyectos de TouchDesigner.

Inglés /日本語

Descripción general

TouchDesigner MCP actúa como un puente entre los modelos de IA y TouchDesigner WebServer DAT, lo que permite a los agentes de IA:

Crear, modificar y eliminar nodos
Propiedades del nodo de consulta y estructura del proyecto
Controlar TouchDesigner programáticamente mediante scripts de Python

Uso

Requiere que Docker o Node.js estén instalados

1. Clonar el repositorio:

git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
cd touchdesigner-mcp

2. Configure el archivo de entorno y compile:

Copie el archivo de plantilla y ajuste TD_WEB_SERVER_HOST y TD_WEB_SERVER_PORT según sea necesario antes de crear la imagen de Docker.

cp dotenv .env
make build

3. Instale el servidor API en su proyecto TouchDesigner:

Inicie TouchDesigner e importe el componente td/mcp_webserver_base.tox directamente en el proyecto de TouchDesigner que desea controlar. Ejemplo: Colóquelo como /project1/mcp_webserver_base

Al importar el tox se activará el script td/import_modules.py , que carga módulos como los controladores del servidor API.

importar

Puede comprobar los registros de arranque abriendo Textport desde el menú TouchDesigner.

importar

4. Inicie el contenedor del servidor MCP

docker-compose up -d

5. Configure su agente de IA para usar el contenedor Docker:

Ejemplo para Claude Desktop

{
  "mcpServers": {
    "touchdesigner": {
      "command": "docker",
      "args": [
        "compose",
        "-f",
        "/path/to/your/touchdesigner-mcp/docker-compose.yml",
        "exec",
        "-i",
        "touchdesigner-mcp-server",
        "node",
        "dist/index.js",
        "--stdio"
      ]
    }
  }
}

En sistemas Windows, incluya la letra de la unidad como C:, por ejemplo C:\\path\\to\\your\\touchdesigner-mcp\\docker-compose.yml

Para utilizar el JS prediseñado directamente desde Node.js:

1. Instalar el paquete

mkdir some && cd ./some  # If you need a new directory
npm install touchdesigner-mcp-server

2. Instale el servidor API en su proyecto TouchDesigner:

Inicie TouchDesigner e importe el componente some/node_modules/touchdesigner-mcp-server/td/mcp_webserver_base.tox directamente en el proyecto de TouchDesigner que desea controlar. Por ejemplo: colóquelo como /project1/mcp_webserver_base

Al importar el tox se activará el script some/node_modules/touchdesigner-mcp-server/td/import_modules.py , que carga módulos como controladores de servidor API.

importar

Puede comprobar los registros de arranque abriendo Textport desde el menú TouchDesigner.

importar

3. Configure su agente de IA:

Ejemplo para Claude Desktop

{
  "mcpServers": {
    "touchdesigner": {
      "args": [
        "/path/to/your/node_modules/touchdesigner-mcp-server/dist/index.js", // <-- Replace with the absolute path to node_modules/touchdesigner-mcp-server/dist/index.js
        "--stdio"
      ],
      "command": "node"
    }
  }
}

En sistemas Windows, incluya la letra de la unidad como C:, por ejemplo C:\\path\\to\\your\\node_modules\\touchdesigner-mcp-server\\dist\\index.js

3. Verificar la conexión

Si se reconoce el servidor MCP, la configuración está completa. Si no se reconoce, intente reiniciar el agente de IA. Si observa un error al iniciar, intente reiniciar el agente después de iniciar TouchDesigner. Cuando el servidor API funciona correctamente en TouchDesigner, el agente puede usar las herramientas proporcionadas para operarlo.

manifestación

Características del servidor MCP

Este servidor permite operaciones en TouchDesigner a través del Protocolo de contexto de modelo (MCP) y proporciona referencias a varios documentos de implementación.

Herramientas

Las herramientas permiten que los agentes de IA realicen acciones en TouchDesigner.

Nombre de la herramienta	Descripción
`create_td_node`	Crear un nuevo nodo.
`delete_td_node`	Eliminar un nodo existente.
`exec_node_method`	Llamar a un método Python en un nodo.
`execute_python_script`	Ejecutar un script de Python arbitrario en TD.
`get_td_class_details`	Obtenga detalles de una clase/módulo de Python de TD.
`get_td_classes`	Obtenga una lista de clases de Python de TouchDesigner.
`get_td_info`	Obtenga información sobre el entorno del servidor TD.
`get_td_node_parameters`	Obtener parámetros de un nodo específico.
`get_td_nodes`	Obtener nodos bajo una ruta principal (opcionalmente filtrada).
`update_td_node_parameters`	Actualizar los parámetros de un nodo específico.

Indicaciones

Las indicaciones proporcionan instrucciones para que los agentes de IA realicen acciones específicas en TouchDesigner.

Nombre del aviso	Descripción
`Search node`	Búsqueda difusa de nodos y recuperación de información según nombre, familia y tipo.
`Node connection`	Proporciona instrucciones para conectar nodos dentro de TouchDesigner.
`Check node errors`	Comprueba los errores de un nodo específico y, de forma recursiva, de los nodos secundarios si los hay.

Recursos

No implementado

Para desarrolladores

Creación de código de cliente y servidor API

cp dotenv .env
Ajuste TD_WEB_SERVER_HOST y TD_WEB_SERVER_PORT en el archivo .env para que coincidan con su entorno de desarrollo
Ejecute make build o npm run build para regenerar el código

Cuando necesite reflejar el código compilado, reinicie tanto el servidor MCP como TouchDesigner.

Verificación del servidor API

npm run test Ejecuta pruebas unitarias para el código del servidor MCP y pruebas de integración con TouchDesigner. Puedes consultar los registros de comunicación abriendo Textport desde el menú de TouchDesigner.
npm run dev Ejecute @modelcontextprotocol/inspector para depurar varias funciones.

Descripción general de la estructura del proyecto

├── src/                       # MCP server source code
│   ├── api/                  # OpenAPI spec for TD WebServer
│   ├── core/                 # Core utilities (logger, error handling)
│   ├── features/             # MCP feature implementations
│   │   ├── prompts/         # Prompt handlers
│   │   ├── resources/       # Resource handlers
│   │   └── tools/           # Tool handlers (e.g., tdTools.ts)
│   ├── gen/                  # Code generated from OpenAPI schema for MCP server
│   ├── server/               # MCP server logic (connections, main server class)
│   ├── tdClient/             # TD connection API client
│   ├── index.ts              # Main entry point for Node.js server
│   └── ...
├── td/                        # TouchDesigner related files
│   ├── modules/              # Python modules for TouchDesigner
│   │   ├── mcp/              # Core logic for handling MCP requests in TD
│   │   │   ├── controllers/ # API request controllers (api_controller.py, generated_handlers.py)
│   │   │   └── services/    # Business logic (api_service.py)
│   │   ├── td_server/        # Python model code generated from OpenAPI schema
│   │   └── utils/            # Shared Python utilities
│   ├── templates/             # Mustache templates for Python code generation
│   ├── genHandlers.js         # Node.js script for generating generated_handlers.py
│   ├── import_modules.py      # Helper script to import API server modules into TD
│   └── mcp_webserver_base.tox # Main TouchDesigner component
├── tests/                      # Test code
│   ├── integration/
│   └── unit/
├── .env                        # Local environment variables (git ignored)
├── dotenv                      # Template for .env
└── orval.config.ts             # Orval config (TS client generation)

Flujo de trabajo de generación de código API

Este proyecto utiliza herramientas de generación de código basadas en OpenAPI (Orval / openapi-generator-cli):

Definición de API: El contrato de API entre el servidor MCP Node.js y el servidor Python que se ejecuta dentro de TouchDesigner se define en src/api/index.yml .

Generación del servidor Python ( npm run gen:webserver ):
- Utiliza openapi-generator-cli a través de Docker.
- Lee src/api/index.yml .
- Genera un esqueleto de servidor Python ( td/modules/td_server/ ) basado en la definición de la API. Este código se ejecuta dentro de TouchDesigner mediante el DAT del servidor web.
- Requiere que Docker esté instalado y en ejecución.
Generación de controladores de Python ( npm run gen:handlers ):
- Utiliza un script Node.js personalizado ( td/genHandlers.js ) y plantillas Mustache ( td/templates/ ).
- Lee el código del servidor Python generado o la especificación OpenAPI.
- Genera implementaciones de controladores ( td/modules/mcp/controllers/generated_handlers.py ) que se conectan a la lógica empresarial en td/modules/mcp/services/api_service.py .
Generación de cliente TypeScript ( npm run gen:mcp ):
- Utiliza Orval para generar código de cliente API y esquemas Zod para la validación de herramientas a partir del esquema YAML incluido en openapi-generator-cli .
- Genera un cliente TypeScript tipificado ( src/tdClient/ ) utilizado por el servidor Node.js para realizar solicitudes al DAT del servidor web.

El proceso de compilación ( npm run build ) ejecuta todos los pasos de generación necesarios ( npm run gen ), seguido de la compilación de TypeScript ( tsc ).

Contribuyendo

¡Agradecemos sus contribuciones!

Bifurcar el repositorio
Crear una rama de características ( git checkout -b feature/amazing-feature )
Realiza tus cambios
Agregue pruebas y asegúrese de que todo funcione ( npm test )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a su rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Incluya siempre pruebas adecuadas al realizar cambios de implementación.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Un servidor de protocolo de contexto de modelo que permite a los agentes de IA controlar y operar proyectos de TouchDesigner mediante la creación, modificación y consulta de nodos y estructuras de proyectos.

Related MCP Servers

Appwrite MCP Serverofficial
appwrite
A
security
A
license
A
quality
A Model Context Protocol server that allows AI assistants to interact with Appwrite's API, providing tools to manage databases, users, functions, teams, and other resources within Appwrite projects.
Last updated -
84
48
Python
MIT License
SupaUI MCP Server
buoooou
A
security
F
license
A
quality
A Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.
Last updated -
3
680
4
TypeScript
MCP Android Agent
nim444
-
security
A
license
-
quality
A Model Context Protocol server that enables AI agents to control and automate Android devices through natural language, supporting actions like app management, UI interactions, and device monitoring.
Last updated -
16
Python
MIT License
Agentic Tools MCP Server
Pimzino
A
security
A
license
A
quality
A Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.
Last updated -
29
108
50
TypeScript
MIT License

View all related MCP servers

TouchDesigner MCP