TouchDesigner
TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-configuration setup for VS Code/Codium.
What is TouchDesigner?
TouchDesigner is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to touchdesigner documentation mcp server v2.6.1 - fixed python api tools! features 629 operators + 14 tutorials + 69 python api classes with working get_python_api & search_python_api tools. zero-config...
TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python API tools! Features 629 operators + 14 tutorials + 69 Python API classes with working get_python_api & search_python_api tools. Zero-configuration setup for VS Code/Codium.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- TouchDesigner Documentation MCP Server v2.6.1 - FIXED Python
Use Cases
Maintainer
Works with
Installation
NPM
npx -y touchdesigner-mcp-serverManual Installation
npx -y touchdesigner-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use TouchDesigner
The TouchDesigner MCP Server connects AI assistants like Claude directly to a live TouchDesigner project, enabling natural language control of operators, parameters, connections, and Python execution within the visual programming environment. It exposes five core tools — listing operators, creating new nodes, setting parameters, wiring connections, and running arbitrary Python — so you can build and modify real-time interactive media installations or generative visuals through conversational prompts. The server communicates with TouchDesigner over a local Web Server DAT on port 9980, making it ideal for artists and developers who want to iterate on visual systems faster without leaving their AI assistant.
Prerequisites
- Node.js 18 or higher installed
- TouchDesigner installed (any recent build)
- Claude Desktop or Claude Code with MCP support
- The touchdesigner-mcp repository cloned locally
- A TouchDesigner project open with a Web Server DAT configured on port 9980 with the td_webserver_callback.py callback loaded
Clone the repository and install dependencies
Clone the touchdesigner-mcp repository and install its Node.js dependencies.
git clone https://github.com/aliphi/touchdesigner-mcp.git
cd touchdesigner-mcp
npm installConfigure the Web Server DAT in TouchDesigner
Inside your open TouchDesigner project, add a Web Server DAT operator, set its port to 9980, enable Active, and replace its default callback script with the contents of td_webserver_callback.py from the cloned repository. Verify the connection by opening http://localhost:9980 in a browser — you should see {"status": "connected", "project": "project1"}.
Register the MCP server with Claude Code
Use claude mcp add to register the server, pointing to the absolute path of server.js in the cloned repository.
claude mcp add touchdesigner -- node /absolute/path/to/touchdesigner-mcp/server.jsOr register manually in claude_desktop_config.json
For Claude Desktop, add the server entry directly to your MCP configuration file. Replace the path with the actual absolute path to server.js on your machine.
{
"mcpServers": {
"touchdesigner": {
"command": "node",
"args": ["/absolute/path/to/touchdesigner-mcp/server.js"]
}
}
}Verify the connection
Restart Claude Desktop (or reload the MCP server in Claude Code) and ask Claude to list the operators in your project. If TouchDesigner is running and the Web Server DAT is active, Claude will respond with the current operator tree.
TouchDesigner Examples
Client configuration
Claude Desktop configuration entry for the TouchDesigner MCP server using a local Node.js process.
{
"mcpServers": {
"touchdesigner": {
"command": "node",
"args": ["/Users/yourname/touchdesigner-mcp/server.js"]
}
}
}Prompts to try
Use these prompts after connecting Claude to a live TouchDesigner session to build and modify visual networks with natural language.
- "List everything at /project1 in my TouchDesigner project"
- "Create a noiseTOP feeding into a levelTOP, then connect both into a compositeTOP"
- "Build a basic 3D scene with a sphere, camera, light, and renderTOP"
- "Set the noisetop1 period parameter to 0.5"
- "Run this Python in TouchDesigner: op('noiseTOP1').par.period = 0.25"Troubleshooting TouchDesigner
Claude cannot connect to TouchDesigner — tools return connection errors
Confirm the Web Server DAT in TouchDesigner is Active and set to port 9980. Open http://localhost:9980 in a browser to verify it returns {"status": "connected"}. Ensure no firewall is blocking localhost port 9980.
Operators are created but at wrong positions or with wrong network path
The server defaults to /project1 as the base path and uses 200px horizontal by 150px vertical spacing conventions. If your project root differs, specify the full path in your prompts (e.g. 'create a noiseTOP at /project1/base1').
td_run_python fails or returns unexpected output
Python executed via the MCP server runs in the TouchDesigner Python environment. Make sure the Python code uses valid TouchDesigner APIs (op(), me., etc.) and that there are no syntax errors. Check the TouchDesigner Textport for error output.
Frequently Asked Questions about TouchDesigner
What is TouchDesigner?
TouchDesigner is a Model Context Protocol (MCP) server that touchdesigner documentation mcp server v2.6.1 - fixed python api tools! features 629 operators + 14 tutorials + 69 python api classes with working get_python_api & search_python_api tools. zero-configuration setup for vs code/codium. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install TouchDesigner?
Install via npm with the command: npx -y touchdesigner-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with TouchDesigner?
TouchDesigner works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is TouchDesigner free to use?
Yes, TouchDesigner is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
TouchDesigner Alternatives — Similar Developer Tools Servers
Looking for alternatives to TouchDesigner? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up TouchDesigner in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use TouchDesigner?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.