touchdesigner-mcp-server 0.4.0-alpha.3 → 0.4.0-alpha.5

package/README.ja.md

@@ -46,6 +46,17 @@ npxを使用する場合、TouchDesignerコンポーネントを別途ダウン
   }
 }
 ```
+
+**TIPS：** `--host`と`--port`引数を追加することで、TouchDesignerサーバー接続をカスタマイズできます：
+```json
+"args": [
+  "-y",
+  "touchdesigner-mcp-server@prerelease",
+  "--stdio",
+  "--host=http://custom_host",
+  "--port=9982"
+]
+```
 </details>
 
 <details>
@@ -59,11 +70,10 @@ git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
 cd touchdesigner-mcp
 ```
 
-##### 2. 環境設定ファイルの設置とコードのビルド
-.envのテンプレートファイルをコピーし、必要に応じて TD_WEB_SERVER_HOST / TD_WEB_SERVER_PORT を調整してから Dockerイメージをビルドしてください。
-
+##### 2. Dockerイメージのビルド
 ```bash
-cp dotenv .env
+git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+cd touchdesigner-mcp
 make build
 ```
 
@@ -103,14 +113,25 @@ docker-compose up -d
         "touchdesigner-mcp-server",
         "node",
         "dist/cli.js",
-        "--stdio"
+        "--stdio",
+        "--host=http://host.docker.internal"
       ]
     }
   }
 }
 ```
 
-*Windows環境では C:\\ の様にドライブレターを含めてください。 例. `C:\\path\\to\\your\\touchdesigner-mcp\\docker-compose.yml`*
+*Windows システムでは、ドライブレターを含めてください。例：`C:\\path\\to\\your\\touchdesigner-mcp\\docker-compose.yml`*
+
+**TIPS：** `--port`引数を追加することで、TouchDesignerサーバー接続をカスタマイズできます：
+  ```json
+"args": [
+  ...,
+  "--stdio",
+  "--host=http://host.docker.internal",
+  "--port=9982"
+]
+  ```
 </details>
 
 
@@ -181,8 +202,10 @@ td/
 
 1. **環境設定:**
    ```bash
-   cp dotenv .env
-   # .env ファイルの TD_WEB_SERVER_HOST, TD_WEB_SERVER_PORT を開発環境に合わせて変更
+   # リポジトリをクローンして依存関係をインストール
+   git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+   cd touchdesigner-mcp
+   npm install
    ```
 
 2. **プロジェクトをビルド:**
@@ -229,8 +252,6 @@ td/
 ├── tests/                      # テストコード
 │   ├── integration/
 │   └── unit/
-├── .env                        # ローカル環境変数 (git無視)
-├── dotenv                      # .env用テンプレート
 └── orval.config.ts             # Orval 設定 (TSクライアント生成)
 ```
 

package/README.md

@@ -47,6 +47,17 @@ Example: Place it as `/project1/mcp_webserver_base`
   }
 }
 ```
+
+**Note:** You can customize the TouchDesigner server connection by adding `--host` and `--port` arguments:
+```json
+"args": [
+  "-y",
+  "touchdesigner-mcp-server@prerelease",
+  "--stdio",
+  "--host=http://custom_host",
+  "--port=9982"
+]
+```
 </details>
 
 <details>
@@ -60,11 +71,10 @@ Example: Place it as `/project1/mcp_webserver_base`
   cd touchdesigner-mcp
   ```
 
-  #### 2. Set up the environment file and build:
-  Copy the template file and adjust the TD_WEB_SERVER_HOST and TD_WEB_SERVER_PORT as needed before building the Docker image.
-
+  #### 2. Build the Docker image:
   ```bash
-  cp dotenv .env
+  git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+  cd touchdesigner-mcp
   make build
   ```
 
@@ -81,7 +91,7 @@ Example: Place it as `/project1/mcp_webserver_base`
 
   ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/textport.png)
 
-  #### 4. Start the MCP server container
+  #### 4. Start the MCP server container with your TouchDesigner configuration
 
   ```bash
   docker-compose up -d
@@ -104,7 +114,8 @@ Example: Place it as `/project1/mcp_webserver_base`
           "touchdesigner-mcp-server",
           "node",
           "dist/cli.js",
-          "--stdio"
+          "--stdio",
+          "--host=http://host.docker.internal"
         ]
       }
     }
@@ -112,6 +123,16 @@ Example: Place it as `/project1/mcp_webserver_base`
   ```
 
   *On Windows systems, include the drive letter like C: e.g. `C:\\path\\to\\your\\touchdesigner-mcp\\docker-compose.yml`*
+
+**Note:** You can customize the TouchDesigner server connection by adding `--host` and `--port` arguments:
+  ```json
+"args": [
+  ...,
+  "--stdio",
+  "--host=http://host.docker.internal",
+  "--port=9982"
+]
+  ```
 </details>
 
 
@@ -183,8 +204,10 @@ Not implemented
 
 1. **Setup environment:**
    ```bash
-   cp dotenv .env
-   # Adjust TD_WEB_SERVER_HOST and TD_WEB_SERVER_PORT in .env file
+   # Clone and install dependencies
+   git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+   cd touchdesigner-mcp
+   npm install
    ```
 
 2. **Build the project:**
@@ -231,8 +254,6 @@ Not implemented
 ├── tests/                      # Test code
 │   ├── integration/
 │   └── unit/
-├── .env                        # Local environment variables (git ignored)
-├── dotenv                      # Template for .env
 └── orval.config.ts             # Orval config (TS client generation)
 ```
 

package/dist/api/customInstance.js

@@ -1,6 +1,5 @@
 import Axios from "axios";
-const API_BASE_URL = `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}`;
-export const AXIOS_INSTANCE = Axios.create(API_BASE_URL ? { baseURL: API_BASE_URL } : {});
+export const AXIOS_INSTANCE = Axios.create();
 export const customInstance = (config, options) => {
     const source = Axios.CancelToken.source();
     const promise = AXIOS_INSTANCE({

package/dist/cli.js

@@ -1,37 +1,67 @@
 #!/usr/bin/env node
-import { resolve } from "node:path";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { config } from "dotenv";
 import { TouchDesignerServer } from "./server/touchDesignerServer.js";
-config({ path: resolve(process.cwd(), ".env") });
+// Note: Environment variables should be set by the Desktop Extensions runtime or CLI arguments
+/**
+ * Parse command line arguments
+ */
+export function parseArgs(args) {
+    const argsToProcess = args || process.argv.slice(2);
+    const parsed = {
+        host: "http://localhost",
+        port: 9981,
+    };
+    for (let i = 0; i < argsToProcess.length; i++) {
+        const arg = argsToProcess[i];
+        if (arg.startsWith("--host=")) {
+            parsed.host = arg.split("=")[1];
+        }
+        else if (arg.startsWith("--port=")) {
+            parsed.port = Number.parseInt(arg.split("=")[1], 10);
+        }
+    }
+    return parsed;
+}
+/**
+ * Determine if the server should run in stdio mode
+ */
+export function isStdioMode(nodeEnv, argv) {
+    const env = nodeEnv ?? process.env.NODE_ENV;
+    const args = argv ?? process.argv;
+    return env === "cli" || args.includes("--stdio");
+}
 /**
  * Start TouchDesigner MCP server
  */
-export async function startServer() {
-    const isStdioMode = process.env.NODE_ENV === "cli" || process.argv.includes("--stdio");
+export async function startServer(params) {
     try {
-        const server = new TouchDesignerServer();
-        if (isStdioMode) {
-            const transport = new StdioServerTransport();
-            const result = await server.connect(transport);
-            if (!result.success) {
-                throw new Error(`Failed to connect: ${result.error.message}`);
-            }
-        }
-        else {
+        const isStdioModeFlag = isStdioMode(params?.nodeEnv, params?.argv);
+        if (!isStdioModeFlag) {
             throw new Error("Sorry, this server is not yet available in the browser. Please use the CLI mode.");
         }
+        // Parse command line arguments and set environment variables
+        const args = parseArgs(params?.argv);
+        process.env.TD_WEB_SERVER_HOST = args.host;
+        process.env.TD_WEB_SERVER_PORT = args.port.toString();
+        const server = new TouchDesignerServer();
+        const transport = new StdioServerTransport();
+        const result = await server.connect(transport);
+        if (!result.success) {
+            throw new Error(`Failed to connect: ${result.error.message}`);
+        }
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        console.error(`Failed to initialize server: ${errorMessage}`);
-        process.exit(1);
+        throw new Error(`Failed to initialize server: ${errorMessage}`);
     }
 }
 // Start server if this file is executed directly
-if (process.argv[1]) {
-    startServer().catch((error) => {
-        console.error("Failed to start server:", error);
-        process.exit(1);
-    });
-}
+startServer({
+    nodeEnv: process.env.NODE_ENV,
+    argv: process.argv,
+}).catch((error) => {
+    console.error("Failed to start server:", error);
+    if (process.env.NODE_ENV === "test")
+        return;
+    process.exit(1);
+});

package/dist/gen/endpoints/TouchDesignerAPI.js

@@ -1,9 +1,9 @@
 /**
- * Generated by orval v7.9.0 🍺
+ * Generated by orval v7.10.0 🍺
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 0.4.0-alpha.3
+ * OpenAPI spec version: 0.4.0-alpha.5
  */
 import { customInstance } from '../../api/customInstance.js';
 // eslint-disable-next-line @typescript-eslint/no-redeclare
@@ -34,7 +34,7 @@ export const TdPythonClassDetailsType = {
 * @summary Delete an existing node
 */
 export const deleteNode = (params, options) => {
-    return customInstance({ url: `http://localhost:9981/api/nodes`, method: 'DELETE',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/nodes`, method: 'DELETE',
         params
     }, options);
 };
@@ -42,7 +42,7 @@ export const deleteNode = (params, options) => {
  * @summary Get nodes in the path
  */
 export const getNodes = (params, options) => {
-    return customInstance({ url: `http://localhost:9981/api/nodes`, method: 'GET',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/nodes`, method: 'GET',
         params
     }, options);
 };
@@ -50,7 +50,7 @@ export const getNodes = (params, options) => {
  * @summary Create a new node
  */
 export const createNode = (createNodeRequest, options) => {
-    return customInstance({ url: `http://localhost:9981/api/nodes`, method: 'POST',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/nodes`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
         data: createNodeRequest
     }, options);
@@ -60,7 +60,7 @@ export const createNode = (createNodeRequest, options) => {
  * @summary Get node detail
  */
 export const getNodeDetail = (params, options) => {
-    return customInstance({ url: `http://localhost:9981/api/nodes/detail`, method: 'GET',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/nodes/detail`, method: 'GET',
         params
     }, options);
 };
@@ -68,7 +68,7 @@ export const getNodeDetail = (params, options) => {
  * @summary Update node properties
  */
 export const updateNode = (updateNodeRequest, options) => {
-    return customInstance({ url: `http://localhost:9981/api/nodes/detail`, method: 'PATCH',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/nodes/detail`, method: 'PATCH',
         headers: { 'Content-Type': 'application/json', },
         data: updateNodeRequest
     }, options);
@@ -78,7 +78,7 @@ export const updateNode = (updateNodeRequest, options) => {
  * @summary Get a list of Python classes and modules
  */
 export const getTdPythonClasses = (options) => {
-    return customInstance({ url: `http://localhost:9981/api/td/classes`, method: 'GET'
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/td/classes`, method: 'GET'
     }, options);
 };
 /**
@@ -86,7 +86,7 @@ export const getTdPythonClasses = (options) => {
  * @summary Get details of a specific Python class or module
  */
 export const getTdPythonClassDetails = (className, options) => {
-    return customInstance({ url: `http://localhost:9981/api/td/classes/${className}`, method: 'GET'
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/td/classes/${className}`, method: 'GET'
     }, options);
 };
 /**
@@ -97,7 +97,7 @@ This allows operations equivalent to TouchDesigner's Python API such as
  * @summary Call a method of the specified node
  */
 export const execNodeMethod = (execNodeMethodRequest, options) => {
-    return customInstance({ url: `http://localhost:9981/api/td/nodes/exec`, method: 'POST',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/td/nodes/exec`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
         data: execNodeMethodRequest
     }, options);
@@ -111,7 +111,7 @@ This endpoint allows you to interact with TouchDesigner nodes programmatically.
  * @summary Execute python code on the server
  */
 export const execPythonScript = (execPythonScriptRequest, options) => {
-    return customInstance({ url: `http://localhost:9981/api/td/server/exec`, method: 'POST',
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/td/server/exec`, method: 'POST',
         headers: { 'Content-Type': 'application/json', },
         data: execPythonScriptRequest
     }, options);
@@ -121,6 +121,6 @@ export const execPythonScript = (execPythonScriptRequest, options) => {
  * @summary Get TouchDesigner information
  */
 export const getTdInfo = (options) => {
-    return customInstance({ url: `http://localhost:9981/api/td/server/td`, method: 'GET'
+    return customInstance({ url: `${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}/api/td/server/td`, method: 'GET'
     }, options);
 };

package/dist/gen/mcp/touchDesignerAPI.zod.js

@@ -1,9 +1,9 @@
 /**
- * Generated by orval v7.9.0 🍺
+ * Generated by orval v7.10.0 🍺
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 0.4.0-alpha.3
+ * OpenAPI spec version: 0.4.0-alpha.5
  */
 import { z as zod } from 'zod';
 /**

package/dist/server/connectionManager.js

@@ -24,10 +24,12 @@ export class ConnectionManager {
         try {
             await this.server.connect(transport);
             this.logger.log(`Server connected and ready to process requests: ${process.env.TD_WEB_SERVER_HOST}:${process.env.TD_WEB_SERVER_PORT}`);
+            // Connection will be checked when tools are actually used
             const connectionResult = await this.checkTDConnection();
             if (!connectionResult.success) {
-                throw new Error(`Failed to connect to TouchDesigner: ${connectionResult.error.message}`);
+                throw new Error(`Failed to connect to TouchDesigner. The mcp_webserver_base on TouchDesigner not currently available: ${connectionResult.error.message}`);
             }
+            this.logger.log("TouchDesigner connection verified");
             return createSuccessResult(undefined);
         }
         catch (error) {

package/dist/server/touchDesignerServer.js

@@ -18,7 +18,7 @@ export class TouchDesignerServer {
     constructor() {
         this.server = new McpServer({
             name: "TouchDesigner",
-            version: "0.4.0-alpha.3",
+            version: "0.4.0-alpha.5",
         }, {
             capabilities: {
                 prompts: {},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "touchdesigner-mcp-server",
-	"version": "0.4.0-alpha.3",
+	"version": "0.4.0-alpha.5",
 	"description": "MCP server for TouchDesigner",
 	"repository": {
 		"type": "git",
@@ -22,29 +22,28 @@
 		"touchdesigner-mcp-server": "dist/cli.js"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.11.1",
+		"@modelcontextprotocol/sdk": "^1.13.2",
 		"@mozilla/readability": "^0.6.0",
 		"@types/axios": "^0.14.4",
 		"@types/ws": "^8.18.1",
 		"@types/yargs": "^17.0.33",
-		"axios": "^1.9.0",
-		"dotenv": "^16.5.0",
-		"zod": "^3.24.4"
+		"axios": "^1.10.0",
+		"zod": "^3.25.67"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "1.9.4",
-		"@openapitools/openapi-generator-cli": "^2.20.0",
+		"@biomejs/biome": "2.0.6",
+		"@openapitools/openapi-generator-cli": "^2.21.0",
 		"@types/jsdom": "^21.1.7",
-		"@types/node": "^22.15.17",
-		"@vitest/coverage-v8": "^3.1.3",
-		"msw": "^2.8.2",
+		"@types/node": "^24.0.7",
+		"@vitest/coverage-v8": "^3.2.4",
+		"msw": "^2.10.2",
 		"mustache": "^4.2.0",
 		"npm-run-all": "^4.1.5",
-		"orval": "^7.9.0",
+		"orval": "^7.10.0",
 		"shx": "^0.4.0",
 		"typescript": "^5.8.3",
-		"vitest": "^3.1.3",
-		"yaml": "^2.7.1"
+		"vitest": "^3.2.4",
+		"yaml": "^2.8.0"
 	},
 	"type": "module",
 	"exports": {