touchdesigner-mcp-server 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.ja.md CHANGED
@@ -6,7 +6,7 @@ TouchDesignerのためのMCP(Model Context Protocol) サーバー実装です。
6
6
 
7
7
  ## 概要
8
8
 
9
- ![demo](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/nodes_list.png)
9
+ [![demo clip](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/particle_on_youtube.png)](https://youtu.be/V2znaqGU7f4?si=6HDFbcBHCFPdttkM&t=635)
10
10
 
11
11
  TouchDesigner MCPは、AIモデルとTouchDesigner WebServer DAT 間のブリッジとして機能し、AIエージェントが以下のことが可能になります
12
12
  - ノードの作成、変更、削除
@@ -17,8 +17,11 @@ TouchDesigner MCPは、AIモデルとTouchDesigner WebServer DAT 間のブリッ
17
17
 
18
18
  *Node.js がインストールされていることが前提となります*
19
19
 
20
+ [![tutorial](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/tutorial.png)](https://www.youtube.com/watch?v=jFaUP1fYum0)
21
+
20
22
  ### 1. touchdesigner-mcp-server パッケージのインストール
21
23
 
24
+ `mkdir some && cd ./some` *(必要に応じて作成)*
22
25
  `npm install touchdesigner-mcp-server`
23
26
 
24
27
  ### 2. TouchDesignerとの接続
@@ -32,10 +35,9 @@ tox のimport により `td/import_modules.py` スクリプトが動作し、API
32
35
 
33
36
  ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/import.png)
34
37
 
35
- #### APIサーバの動作確認
36
- `npm run test` を実行することでMCPサーバーコードのユニットテストと TouchDesigner への接続テストが実行されます。
37
- このテストでは `td/modules` ディレクトリ内のPythonモジュールが `mcp_webserver_base` コンポーネントからアクセス可能であることを確認します。
38
- TouchDesigner のメニューから Textportを起動すると通信のログを確認することができます。
38
+ TouchDesigner のメニューから Textportを起動してサーバーの起動ログを確認することができます。
39
+
40
+ ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/textport.png)
39
41
 
40
42
  ### 3. TouchDesigner MCP Server の設定
41
43
  TouchDesignerが起動した状態で、AIエージェント(Claude Desktop,Cursor, VSCode CopilotChatなど)をMCPサーバーに接続するように設定します。
@@ -60,6 +62,7 @@ MCPサーバーが認識されていればセットアップは完了です。
60
62
  起動時にエラーが表示される場合はTouchDesignerを先に起動してから再度エージェントを起動してください。
61
63
  TouchDesigner で APIサーバーが実行されていれば、エージェントは提供された TouchDesigner ツールを通じてTouchDesignerを使用できます。
62
64
 
65
+ ![demo](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/nodes_list.png)
63
66
 
64
67
  ## MCPサーバーの機能
65
68
 
package/README.md CHANGED
@@ -6,7 +6,7 @@ This is an implementation of an MCP (Model Context Protocol) server for TouchDes
6
6
 
7
7
  ## Overview
8
8
 
9
- ![demo](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/nodes_list.png)
9
+ [![demo clip](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/particle_on_youtube.png)](https://youtu.be/V2znaqGU7f4?si=6HDFbcBHCFPdttkM&t=635)
10
10
 
11
11
  TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebServer DAT, enabling AI agents to:
12
12
  - Create, modify, and delete nodes
@@ -17,8 +17,11 @@ TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebSe
17
17
 
18
18
  *Requires Node.js to be installed*
19
19
 
20
+ [![tutorial](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/tutorial.png)](https://www.youtube.com/watch?v=jFaUP1fYum0)
21
+
20
22
  ### 1. Install the touchdesigner-mcp-server package
21
23
 
24
+ `mkdir some && cd ./some` *(If you need)*
22
25
  `npm install touchdesigner-mcp-server`
23
26
 
24
27
  ### 2. Connect to TouchDesigner
@@ -32,10 +35,9 @@ Importing the tox will trigger the `td/import_modules.py` script, which loads mo
32
35
 
33
36
  ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/import.png)
34
37
 
35
- #### Verify API server operation
36
- Run `npm run test` to execute unit tests for the MCP server code and connection tests to TouchDesigner.
37
- This test ensures that the Python modules in the `td/modules` directory are accessible from the `mcp_webserver_base` component.
38
- You can check communication logs by opening the Textport from the TouchDesigner menu.
38
+ You can check boot logs by opening the Textport from the TouchDesigner menu.
39
+
40
+ ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/textport.png)
39
41
 
40
42
  ### 3. Configure the TouchDesigner MCP Server
41
43
  With TouchDesigner running, configure your AI agent (Claude Desktop, Cursor, VSCode CopilotChat, etc.) to connect to the MCP server.
@@ -60,6 +62,8 @@ If the MCP server is recognized, setup is complete.
60
62
  If you see an error at startup, try launching the agent again after starting TouchDesigner.
61
63
  If the API server is running in TouchDesigner, the agent can use TouchDesigner via the provided tools.
62
64
 
65
+ ![demo](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/nodes_list.png)
66
+
63
67
 
64
68
  ## MCP Server Features
65
69
 
@@ -18,7 +18,7 @@ export const TOOL_NAMES = {
18
18
  GET_TD_NODES: "get_td_nodes",
19
19
  UPDATE_TD_NODE_PARAMETERS: "update_td_node_parameters",
20
20
  };
21
- export const REFERENCE_COMMENT = `Check reference resources: ${TD_PYTHON_CLASS_REFERENCE_INDEX_URL}.`;
21
+ export const REFERENCE_COMMENT = `Check reference resources: ${TD_PYTHON_CLASS_REFERENCE_INDEX_URL}`;
22
22
  export const PROMPT_NAMES = {
23
23
  SEARCH_NODE: "Search node",
24
24
  CHECK_NODE_ERRORS: "Check node errors",
@@ -3,7 +3,7 @@
3
3
  * Do not edit manually.
4
4
  * TouchDesigner API
5
5
  * OpenAPI schema for generating TouchDesigner API client code
6
- * OpenAPI spec version: 0.2.5
6
+ * OpenAPI spec version: 0.2.7
7
7
  */
8
8
  import { customInstance } from '../../api/customInstance.js';
9
9
  // eslint-disable-next-line @typescript-eslint/no-redeclare
@@ -3,7 +3,7 @@
3
3
  * Do not edit manually.
4
4
  * TouchDesigner API
5
5
  * OpenAPI schema for generating TouchDesigner API client code
6
- * OpenAPI spec version: 0.2.5
6
+ * OpenAPI spec version: 0.2.7
7
7
  */
8
8
  import { z as zod } from 'zod';
9
9
  /**
@@ -18,7 +18,7 @@ export class TouchDesignerServer {
18
18
  constructor() {
19
19
  this.server = new McpServer({
20
20
  name: "TouchDesigner",
21
- version: "0.2.5",
21
+ version: "0.2.7",
22
22
  }, {
23
23
  capabilities: {
24
24
  prompts: {},
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "touchdesigner-mcp-server",
3
- "version": "0.2.5",
3
+ "version": "0.2.7",
4
4
  "description": "MCP server for TouchDesigner",
5
5
  "repository": {
6
6
  "type": "git",
@@ -2,7 +2,7 @@ openapi: 3.0.0
2
2
  info:
3
3
  description: OpenAPI schema for generating TouchDesigner API client code
4
4
  title: TouchDesigner API
5
- version: 0.2.5
5
+ version: 0.2.7
6
6
  servers:
7
7
  - url: "{baseUrl}"
8
8
  variables: