tdmcp — TouchDesigner MCP server

MindDesigner (tdmcp) — TouchDesigner MCP サーバー

tdmcp は TouchDesigner 用の Model Context Protocol（MCP）サーバーです。自然な言葉で指示するだけで、TouchDesigner を構築できます。ビジュアルを AI アシスタント（Claude、Claude Code、Cursor、Codex）に説明すると、AI がプロジェクト内に実際のノードネットワークを構築し、エラーをチェックして、プレビューを表示します。

「ノイズからブラーとディスプレイスを使ったフィードバックトンネルを作成してから、ブルームを追加し、ウィンドウに出力して。」

すると、/project1 にノードが作成され、接続されます。

これを実現しているのは、ほかのツールにはなかった次の2つの要素を組み合わせているからです。

• 実用的な知識 — 629 個のオペレーター、68 個の Python クラス、ワークフローパターン、GLSL テクニック、チュートリアルを収録した組み込みリファレンスにより、AI は推測ではなく、実際の TouchDesigner オペレーターを使えます。
• 実際の実行機能 — TouchDesigner 内で動作する小さなブリッジが、ノードを実際に作成、接続、検査、プレビューします。作成 → 検証 → プレビューのループにより、AI は自分の作業を確認して修正できます。生成されたネットワークはすべて、自動的に読みやすい左から右へのレイアウトに配置されます。

📖 ドキュメント

ガイドとリファレンスの全文は、ドキュメントサイト → https://pantani.github.io/tdmcp/ をご覧ください。

🇧🇷 ポルトガル語のドキュメント： https://pantani.github.io/tdmcp/pt/

仕組み

お使いのコンピューター上で、次の3つの要素が連携します。

   You + your AI            tdmcp server               TouchDesigner
  (Claude / Cursor)   ─▶   (a small program)    ─▶   (the bridge inside TD)
   "make a feedback                                      builds real nodes
    tunnel from noise"                                   in /project1

1. AI アシスタント — 作りたいものを入力する場所です。
2. tdmcp サーバー — AI に TouchDesigner の「ツール」とオペレーターのナレッジベースを提供する、小さな Node プログラムです。一度インストールすれば使えます。
3. ブリッジ — サーバーから TouchDesigner を実際に操作できるよう、TouchDesigner 内で動作する小さなプログラムです。マシンごとに一度オンにします。

必要なもの

• TouchDesigner — 無料の非商用版で問題ありません。
• MCP 対応の AI アシスタント：Claude Desktop（最も簡単）、Claude Code、 Codex、または Cursor。

ソースからビルドする場合のみ、Node.js が必要です（Node 20+）。 ワンクリックでインストールできる Claude Desktop 拡張機能には、追加で必要なものはありません。サーバーは .mcpb 拡張機能ファイルに同梱されています。

はじめに

AI（tdmcp ツールを使えるようにするため）と TouchDesigner（AI が操作できるようにするため）の 両方をセットアップします。

🤖 最も簡単 — AI にインストールさせる。 Claude Code、Codex、または Cursor を使っていますか？次のメッセージを貼り付けてください：

Install and connect tdmcp for me using the official install guide:
https://pantani.github.io/tdmcp/guide/install
Do every step yourself; only stop when you need me to do the TouchDesigner bridge step.

すべてをクローンし、ビルドして接続します。手動で行う必要があるのは、TouchDesigner に1行貼り付けることだけです（下記のステップ2）。

🟢 Claude Desktop — ワンクリック .mcpb（ターミナル不要、Node 不要）。 tdmcp.mcpb をダウンロードし、 Claude Desktop で Settings → Extensions を開いてインストールします（ドラッグするか、 Install from file を選択）。ホストとポートは 127.0.0.1 / 9980 のままにします。詳しい手順は インストールガイドをご覧ください。

🛠️ Claude Code / Codex / Cursor — ソースからビルド。

git clone https://github.com/Pantani/tdmcp.git
cd tdmcp
npm run setup   # installs, builds, and prints the exact line to connect your client

TouchDesigner 内でブリッジを有効にする（すべてのユーザー向け）

最も簡単 — Textport 不要。 最新リリースから tdmcp_bridge_package.tox をダウンロードし、/project1 ネットワークにドラッグして、コンポーネントの Install をクリックします。 パッケージが自動的にセットアップされ、ポート 9980 でブリッジが起動します。✅

import urllib.request; exec(urllib.request.urlopen("https://github.com/Pantani/tdmcp/raw/v0.13.2/td/bootstrap.py").read().decode())

どちらの方法も安全で、元に戻せます。コンポーネントが1つ追加されるだけです。後で削除するには from mcp import install; install.uninstall() を実行します。その他のインストール方法（モジュール パス、ターミナル、Palette パッケージ）は、 ブリッジのドキュメントをご覧ください。

作ってみる

TouchDesigner を開き、AI に接続した状態で、自然な言葉で次のように頼みます：

「音に反応するパーティクル銀河を作成して、プレビューを表示してください。」

AI がネットワークを構築し、エラーを確認して、サムネイルを返します。さらに調整しましょう： 「もっと暖色にして」「フィードバックの軌跡を追加して」「全画面で出力して」。 アイデアはプロンプト集にもあります。

接続できませんか？ よくある対処法は2つです。ブリッジが起動していること（curl http://127.0.0.1:9980/api/info が JSON を返す）を確認し、サーバーを追加した後に AI クライアントを再起動してください。詳しくは トラブルシューティングをご覧ください。

できること

508 個のツールを3つのレイヤーで提供し、基盤プリミティブ、CLI による自動化、 ライブラリ／パッケージング、AI セッションメモリ、 Obsidian Vault との連携も備えています。1行で使えるアーティスト向けジェネレーター （create_feedback_network、create_audio_reactive、create_particle_system、 create_generative_art、…）から、構成要素（create_control_panel、 animate_parameter、OSC/MIDI/DMX/NDI 用の create_external_io、…）、さらに アトミックなノードの CRUD や検査まで対応します。多くのシステムは、調整、プリセット化、コントローラーへの割り当てができるコントロールパネル付きで、すぐに操作できる状態で提供されます。常に最新の ツールリファレンスと レシピギャラリーをご覧ください。

オプション：クリエイティブ RAG

AI がインスピレーションを得るために検索できる、オープンライセンスのアート作品・アーティスト・技法を集めた、ローカルでオプトイン方式の創造的なレパートリーです。デフォルトでは無効です。レパートリーであり、ポリシーではありません。ブリッジ、DMX、Python の実行は行いません。TDMCP_RAG_ENABLED=1 とローカルの Ollama のインストールを有効にしてから、tdmcp creative-rag {sync|index|search} を実行してください。 詳細なガイド：docs/CREATIVE_RAG.md。

セキュリティ

ブリッジは TD プロセス内で任意の Python コードを実行し、すべてのインターフェースでポート 9980 をリッスンします。このマシンへの開かれた扉として扱ってください。信頼できるネットワークでのみ実行し、信頼できないネットワークではブリッジ認証 （TDMCP_BRIDGE_TOKEN）を有効にするか、実行エンドポイント （TDMCP_BRIDGE_ALLOW_EXEC=0）を無効にしてください。詳細： セキュリティ。

リンクとコミュニティ

• Glama MCP ディレクトリ — tdmcp の掲載ページ：https://glama.ai/mcp/servers/Pantani/tdmcp
• awesome-touchdesigner — コミュニティがまとめた TouchDesigner のリスト：https://github.com/monkeymonk/awesome-touchdesigner
• ドキュメントサイト — https://pantani.github.io/tdmcp/ · ロードマップ — docs/ROADMAP.md

貢献と開発

npm install && npm run build でビルドし、npm test、npm run typecheck、 npm run lint を実行します。npm run docs:dev でドキュメントを編集できます（ ツールリファレンス は scripts/gen-tool-docs.ts によって生成されます）。CONTRIBUTING.md、 CHANGELOG.md、およびロードマップを参照してください。

ライセンス

MIT — LICENSE を参照してください。