touchdesigner-mcp-server 1.1.2 → 1.3.0

package/README.ja.md

@@ -52,14 +52,14 @@ flowchart LR
 ## 利用方法
 
 <details>
-  <summary>方法1: Claude Desktop + Desktop Extensions（推奨）</summary>
+  <summary>方法1: Claude Desktop + MCP Bundle（推奨）</summary>
 
 ##### 1. ファイルをダウンロード
 
 [リリースページ](https://github.com/8beeeaaat/touchdesigner-mcp/releases/latest)から以下をダウンロード：
 
 - **TouchDesigner Components**: `touchdesigner-mcp-td.zip`
-- **Desktop Extensions (.dxt)**: `touchdesigner-mcp.dxt`
+- **[MCP Bundle](https://github.com/modelcontextprotocol/mcpb) (.mcpb)**: `touchdesigner-mcp.mcpb`
 
 ##### 2. TouchDesignerコンポーネントを設置
 
@@ -73,13 +73,13 @@ flowchart LR
 
   ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/textport.png)
 
-##### 3. Desktop Extensionをインストール
+##### 3. MCP Bundleをインストール
 
-`touchdesigner-mcp.dxt`ファイルをダブルクリックしてClaude Desktopに拡張機能をインストール
+`touchdesigner-mcp.mcpb`ファイルをダブルクリックしてClaude DesktopにMCP Bundleをインストール
 
 <https://github.com/user-attachments/assets/0786d244-8b82-4387-bbe4-9da048212854>
 
-##### 4. 拡張機能が自動的にTouchDesignerサーバー接続を処理
+##### 4. MCP Bundleが自動的にTouchDesignerサーバー接続を処理
 
 **⚠️ 重要:** TouchDesignerコンポーネントのディレクトリ構造は展開した状態を正確に保持してください。`mcp_webserver_base.tox`コンポーネントは`modules/`ディレクトリやその他のファイルへの相対パスを参照しています。
 
@@ -250,9 +250,11 @@ td/
 | `delete_td_node`            | 既存のノードを削除します。                     |
 | `exec_node_method`          | ノードに対してPythonメソッドを呼び出します。   |
 | `execute_python_script`     | TD内で任意のPythonスクリプトを実行します。     |
+| `get_module_help`           | TouchDesignerモジュール/クラスのPython help()ドキュメントを取得します。 |
 | `get_td_class_details`      | TD Pythonクラス/モジュールの詳細情報を取得します。 |
 | `get_td_classes`            | TouchDesigner Pythonクラスのリストを取得します。 |
 | `get_td_info`           | TDサーバー環境に関する情報を取得します。       |
+| `get_td_node_errors`        | 指定されたノードとその子ノードのエラーをチェックします。 |
 | `get_td_node_parameters`    | 特定ノードのパラメータを取得します。           |
 | `get_td_nodes`              | 親パス内のノードを取得します（オプションでフィルタリング）。 |
 | `update_td_node_parameters` | 特定ノードのパラメータを更新します。           |
@@ -354,6 +356,24 @@ td/
 
 ビルドプロセス (`npm run build`) は、必要なすべての生成ステップ (`npm run gen`) を実行し、その後にTypeScriptコンパイル (`tsc`) を行います。
 
+### バージョン管理
+
+- `package.json` はすべてのコンポーネントバージョンの唯一の信頼できる情報源です（Node.js MCPサーバー、TouchDesigner Python API、MCPバンドル、および `server.json` メタデータ）。
+- バージョンを更新する際は `npm version <patch|minor|major>`（または内部で使用される `npm run gen:version`）を実行してください。このスクリプトは `pyproject.toml`、`td/modules/utils/version.py`、`mcpb/manifest.json`、および `server.json` を書き換え、リリースワークフローがタグ値を信頼できるようにします。
+- GitHubリリースワークフロー（`.github/workflows/release.yml`）はコミットを `v${version}` としてタグ付けし、同じバージョン番号から `touchdesigner-mcp-td.zip` / `touchdesigner-mcp.mcpb` を公開します。リリースをトリガーする前に必ず同期ステップを実行し、すべてのアーティファクトが整合するようにしてください。
+
+## トラブルシューティング
+
+### バージョン互換性のトラブルシューティング
+
+- `ConnectionManager.connect` の実行中、MCPサーバーは自身のバージョンと `getTdInfo` が報告するTouchDesigner APIサーバーのバージョンを比較します。APIサーバーがバージョンを公開していない場合、またはバージョンが異なる場合（例：片方のみが更新された場合）、MCPサーバーはClaude/Codexコンソールおよび TouchDesigner ログ DAT に説明的なエラーメッセージを表示して接続を中止します。
+- 不一致を解決するには、TouchDesignerコンポーネントを再インストールしてください：
+  1. リリースページから最新の [touchdesigner-mcp-td.zip](https://github.com/8beeeaaat/touchdesigner-mcp/releases/latest/download/touchdesigner-mcp-td.zip) をダウンロードします。
+  2. 既存の `touchdesigner-mcp-td` フォルダを削除し、新しく展開した内容に置き換えます。
+  3. TouchDesignerプロジェクトから古い `mcp_webserver_base` コンポーネントを削除し、新しいフォルダから `.tox` をインポートします。
+  4. TouchDesignerとMCPサーバーを実行しているAIエージェント（例：Claude Desktop）を再起動します。
+- ローカルで開発している場合は、`package.json` を編集した後に `npm run gen:version` を実行してください（または単に `npm version ...` を使用してください）。これにより、Python API（`pyproject.toml` + `td/modules/utils/version.py`）、MCPバンドルマニフェスト、およびレジストリメタデータが同期され、ランタイム互換性チェックが成功するようになります。
+
 ## 開発で貢献
 
 ぜひ一緒に改善しましょう！

package/README.md

@@ -52,14 +52,14 @@ flowchart LR
 ## Usage
 
 <details>
-  <summary>Method 1: Using Claude Desktop and Desktop Extensions (Recommended)</summary>
+  <summary>Method 1: Using Claude Desktop and MCP Bundle (Recommended)</summary>
 
 ### 1. Download Files
 
 Download the following from the [releases page](https://github.com/8beeeaaat/touchdesigner-mcp/releases/latest):
 
 - **TouchDesigner Components**: `touchdesigner-mcp-td.zip`
-- **Desktop Extension (.dxt)**: `touchdesigner-mcp.dxt`
+- **[MCP Bundle](https://github.com/modelcontextprotocol/mcpb) (.mcpb)**: `touchdesigner-mcp.mcpb`
 
 ### 2. Set up TouchDesigner Components
 
@@ -73,15 +73,15 @@ Download the following from the [releases page](https://github.com/8beeeaaat/tou
 
   ![import](https://github.com/8beeeaaat/touchdesigner-mcp/blob/main/assets/textport.png)
 
-### 3. Install the Desktop Extension
+### 3. Install the MCP Bundle
 
-Double-click the `touchdesigner-mcp.dxt` file to install the extension in Claude Desktop.
+Double-click the `touchdesigner-mcp.mcpb` file to install the bundle in Claude Desktop.
 
 <https://github.com/user-attachments/assets/0786d244-8b82-4387-bbe4-9da048212854>
 
 ### 4. Connect to the Server
 
-The extension will automatically handle the connection to the TouchDesigner server.
+The MCP bundle will automatically handle the connection to the TouchDesigner server.
 
 **⚠️ Important:** The directory structure must be preserved exactly as extracted. The `mcp_webserver_base.tox` component references relative paths to the `modules/` directory and other files.
 
@@ -250,9 +250,11 @@ Tools allow AI agents to perform actions in TouchDesigner.
 | `delete_td_node`        | Deletes an existing node.                                          |
 | `exec_node_method`      | Calls a Python method on a node.                                   |
 | `execute_python_script` | Executes an arbitrary Python script in TouchDesigner.              |
+| `get_module_help`       | Gets Python help() documentation for TouchDesigner modules/classes.|
 | `get_td_class_details`  | Gets details of a TouchDesigner Python class or module.            |
 | `get_td_classes`        | Gets a list of TouchDesigner Python classes.                       |
 | `get_td_info`           | Gets information about the TouchDesigner server environment.       |
+| `get_td_node_errors`    | Checks for errors on a specified node and its children. |
 | `get_td_node_parameters`| Gets the parameters of a specific node.                            |
 | `get_td_nodes`          | Gets nodes under a parent path, with optional filtering.           |
 | `update_td_node_parameters` | Updates the parameters of a specific node.                     |
@@ -354,6 +356,24 @@ This project uses OpenAPI-based code generation tools (Orval and openapi-generat
 
 The build process (`npm run build`) runs all necessary generation steps (`npm run gen`), followed by TypeScript compilation (`tsc`).
 
+### Version management
+
+- `package.json` is the single source of truth for every component version (Node.js MCP server, TouchDesigner Python API, MCP bundle, and `server.json` metadata).
+- Run `npm version <patch|minor|major>` (or the underlying `npm run gen:version`) whenever you bump the version. The script rewrites `pyproject.toml`, `td/modules/utils/version.py`, `mcpb/manifest.json`, and `server.json` so that the release workflow can trust the tag value.
+- The GitHub release workflow (`.github/workflows/release.yml`) tags the commit as `v${version}` and publishes `touchdesigner-mcp-td.zip` / `touchdesigner-mcp.mcpb` from the exact same version number. Always run the sync step before triggering a release so that every artifact stays aligned.
+
+## Troubleshooting
+
+### Troubleshooting version compatibility
+
+- During `ConnectionManager.connect` the MCP server compares its own version with the TouchDesigner API server version reported by `getTdInfo`. If the API server does not expose a version or the versions differ (for example because only one side was updated), the MCP server aborts the connection with a descriptive error message in the Claude/Codex console and in the TouchDesigner log DAT.
+- To resolve the mismatch, reinstall both the TouchDesigner components
+  1. Download the latest [touchdesigner-mcp-td.zip](https://github.com/8beeeaaat/touchdesigner-mcp/releases/latest/download/touchdesigner-mcp-td.zip) from the releases page.
+  2. Delete the existing \`touchdesigner-mcp-td\` folder and replace it with the newly extracted contents.
+  3. Remove the old \`mcp_webserver_base\` component from your TouchDesigner project and import the \`.tox\` from the new folder.
+  4. Restart TouchDesigner and the AI agent running the MCP server (e.g., Claude Desktop).
+- When developing locally, run `npm run gen:version` after editing `package.json` (or simply use `npm version ...`). This keeps the Python API (`pyproject.toml` + `td/modules/utils/version.py`), MCP bundle manifest, and registry metadata in sync so that the runtime compatibility check succeeds.
+
 ## Contributing
 
 We welcome your contributions!

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { TouchDesignerServer } from "./server/touchDesignerServer.js";
-// Note: Environment variables should be set by the Desktop Extensions runtime or CLI arguments
+// Note: Environment variables should be set by the MCP Bundle runtime or CLI arguments
 const DEFAULT_HOST = "http://127.0.0.1";
 const DEFAULT_PORT = 9981;
 /**
@@ -59,8 +59,8 @@ export async function startServer(params) {
 }
 // Start server if this file is executed directly
 startServer({
-    nodeEnv: process.env.NODE_ENV,
     argv: process.argv,
+    nodeEnv: process.env.NODE_ENV,
 }).catch((error) => {
     console.error("Failed to start server:", error);
     if (process.env.NODE_ENV === "test")

package/dist/core/constants.js

@@ -10,18 +10,20 @@ export const TOOL_NAMES = {
     CREATE_TD_NODE: "create_td_node",
     DELETE_TD_NODE: "delete_td_node",
     DESCRIBE_TD_TOOLS: "describe_td_tools",
-    EXECUTE_PYTHON_SCRIPT: "execute_python_script",
     EXECUTE_NODE_METHOD: "exec_node_method",
-    GET_TD_INFO: "get_td_info",
+    EXECUTE_PYTHON_SCRIPT: "execute_python_script",
     GET_TD_CLASS_DETAILS: "get_td_class_details",
     GET_TD_CLASSES: "get_td_classes",
+    GET_TD_INFO: "get_td_info",
+    GET_TD_MODULE_HELP: "get_td_module_help",
+    GET_TD_NODE_ERRORS: "get_td_node_errors",
     GET_TD_NODE_PARAMETERS: "get_td_node_parameters",
     GET_TD_NODES: "get_td_nodes",
     UPDATE_TD_NODE_PARAMETERS: "update_td_node_parameters",
 };
 export const REFERENCE_COMMENT = `Check reference resources: ${TD_PYTHON_CLASS_REFERENCE_INDEX_URL}`;
 export const PROMPT_NAMES = {
-    SEARCH_NODE: "Search node",
     CHECK_NODE_ERRORS: "Check node errors",
     NODE_CONNECTION: "Node connection",
+    SEARCH_NODE: "Search node",
 };

package/dist/core/errorHandling.js

@@ -5,15 +5,30 @@ export function handleToolError(error, logger, toolName, referenceComment) {
     const formattedError = error instanceof Error
         ? error
         : new Error(error === null ? "Null error received" : String(error));
-    logger.error(toolName, formattedError);
+    const logData = {
+        error: formattedError.message,
+        message: "Tool execution failed",
+        toolName,
+    };
+    if (referenceComment) {
+        logData.referenceComment = referenceComment;
+    }
+    if (formattedError.stack) {
+        logData.stack = formattedError.stack;
+    }
+    logger.sendLog({
+        data: logData,
+        level: "error",
+        logger: "ErrorHandling",
+    });
     const errorMessage = `${toolName}: ${formattedError}${referenceComment ? `. ${referenceComment}` : ""}`;
     return {
-        isError: true,
         content: [
             {
-                type: "text",
                 text: errorMessage,
+                type: "text",
             },
         ],
+        isError: true,
     };
 }

package/dist/core/logger.js

@@ -7,39 +7,17 @@ export class McpLogger {
     constructor(server) {
         this.server = server;
     }
-    // biome-ignore lint/suspicious/noExplicitAny: logging accepts any type
-    log(...args) {
-        this.sendLog("info", args);
-    }
-    // biome-ignore lint/suspicious/noExplicitAny: logging accepts any type
-    debug(...args) {
-        this.sendLog("debug", args);
-    }
-    // biome-ignore lint/suspicious/noExplicitAny: logging accepts any type
-    warn(...args) {
-        this.sendLog("warning", args);
-    }
-    // biome-ignore lint/suspicious/noExplicitAny: logging accepts any type
-    error(...args) {
-        this.sendLog("error", args);
-    }
-    sendLog(level, 
-    // biome-ignore lint/suspicious/noExplicitAny: logging accepts any type
-    args) {
-        for (const arg of args) {
-            try {
-                this.server.server.sendLoggingMessage({
-                    level,
-                    data: arg,
-                });
-            }
-            catch (error) {
-                if (error instanceof Error && error.message === "Not connected") {
-                    return;
-                }
-                console.error(`Failed to send log to MCP server: ${error instanceof Error ? error.message : String(error)}`);
-                console[level === "warning" ? "warn" : level]?.(arg);
+    sendLog(args) {
+        try {
+            this.server.server.sendLoggingMessage({
+                ...args,
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.message === "Not connected") {
+                return;
             }
+            console.error(`Failed to send log to MCP server: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
 }

package/dist/core/result.js

@@ -2,11 +2,11 @@
  * Creates a success result with the provided data
  */
 export function createSuccessResult(data) {
-    return { success: true, data };
+    return { data, success: true };
 }
 /**
  * Creates an error result with the provided error
  */
 export function createErrorResult(error) {
-    return { success: false, error };
+    return { error, success: false };
 }

package/dist/core/version.js

@@ -0,0 +1,4 @@
+import { createRequire } from "node:module";
+const requirePackage = createRequire(import.meta.url);
+const packageJson = requirePackage("../../package.json");
+export const PACKAGE_VERSION = packageJson.version ?? "0.0.0";

package/dist/features/prompts/handlers/td_prompts.js

@@ -2,40 +2,40 @@ import { GetPromptRequestSchema, ListPromptsRequestSchema, } from "@modelcontext
 import { PROMPT_NAMES, TOOL_NAMES } from "../../../core/constants.js";
 const PROMPTS = [
     {
-        name: PROMPT_NAMES.SEARCH_NODE,
-        description: "Fuzzy search for node",
         arguments: [
             {
-                name: "nodeName",
                 description: "Name of the node to check",
+                name: "nodeName",
                 required: true,
             },
             {
-                name: "nodeFamily",
                 description: "Family of the node to check",
+                name: "nodeFamily",
                 required: false,
             },
             {
-                name: "nodeType",
                 description: "Type of the node to check",
+                name: "nodeType",
                 required: false,
             },
         ],
+        description: "Fuzzy search for node",
+        name: PROMPT_NAMES.SEARCH_NODE,
     },
     {
-        name: PROMPT_NAMES.CHECK_NODE_ERRORS,
-        description: "Fuzzy search for node and return errors in TouchDesigner.",
         arguments: [
             {
-                name: "nodePath",
                 description: "Path to the node to check",
+                name: "nodePath",
                 required: true,
             },
         ],
+        description: "Fuzzy search for node and return errors in TouchDesigner.",
+        name: PROMPT_NAMES.CHECK_NODE_ERRORS,
     },
     {
-        name: PROMPT_NAMES.NODE_CONNECTION,
         description: "Connect nodes between each other in TouchDesigner.",
+        name: PROMPT_NAMES.NODE_CONNECTION,
     },
 ];
 /**
@@ -49,7 +49,10 @@ export function registerTdPrompts(server, logger) {
     });
     server.server.setRequestHandler(GetPromptRequestSchema, (request) => {
         try {
-            logger.debug(`Handling GetPromptRequest: ${request.params.name}`);
+            logger.sendLog({
+                data: `Handling GetPromptRequest: ${request.params.name}`,
+                level: "debug",
+            });
             const prompt = getPrompt(request.params.name);
             if (!prompt) {
                 throw new Error("Prompt name is required");
@@ -60,8 +63,8 @@ export function registerTdPrompts(server, logger) {
                 }
                 const { nodeName, nodeFamily, nodeType } = request.params.arguments;
                 const messages = handleSearchNodePrompt({
-                    nodeName,
                     nodeFamily,
+                    nodeName,
                     nodeType,
                 });
                 return { messages };
@@ -84,7 +87,10 @@ export function registerTdPrompts(server, logger) {
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            logger.error(`Error handling prompt request: ${errorMessage}`);
+            logger.sendLog({
+                data: `Error handling prompt request: ${errorMessage}`,
+                level: "error",
+            });
             throw new Error(errorMessage);
         }
     });
@@ -92,33 +98,33 @@ export function registerTdPrompts(server, logger) {
 function handleSearchNodePrompt(params) {
     return [
         {
-            role: "user",
             content: {
-                type: "text",
                 text: `Use the "${TOOL_NAMES.GET_TD_NODES}", "${TOOL_NAMES.GET_TD_NODE_PARAMETERS}" tools to search nodes what named "${params.nodeName}" in the TouchDesigner project.${params.nodeType ? ` Node Type: ${params.nodeType}.` : ""}${params.nodeFamily ? ` Node Family: ${params.nodeFamily}.` : ""}`,
+                type: "text",
             },
+            role: "user",
         },
     ];
 }
 function handleCheckNodeErrorsPrompt(params) {
     return [
         {
-            role: "user",
             content: {
+                text: `Use the "${TOOL_NAMES.GET_TD_NODE_ERRORS}" tool to inspect "${params.nodePath}" (and optionally its children) for error messages. If errors are returned, examine the affected nodes' parameters and connections to resolve them.`,
                 type: "text",
-                text: `Use the "${TOOL_NAMES.EXECUTE_NODE_METHOD}" like "op('${params.nodePath}').errors()" tool to check node errors. If there are any errors, please check the node parameters and connections. If the node has children, please check the child nodes as well. Please check the node connections and parameters. If the node has children, please check the child nodes as well.`,
             },
+            role: "user",
         },
     ];
 }
 function handleNodeConnectionPrompt() {
     return [
         {
-            role: "user",
             content: {
-                type: "text",
                 text: `Use the "${TOOL_NAMES.EXECUTE_PYTHON_SCRIPT}" tool e.g. op('/project1/text_over_image').outputConnectors[0].connect(op('/project1/out1'))`,
+                type: "text",
             },
+            role: "user",
         },
     ];
 }

package/dist/features/tools/handlers/tdTools.js

@@ -1,19 +1,21 @@
 import { z } from "zod";
 import { REFERENCE_COMMENT, TOOL_NAMES } from "../../../core/constants.js";
 import { handleToolError } from "../../../core/errorHandling.js";
-import { createNodeBody, deleteNodeQueryParams, execNodeMethodBody, execPythonScriptBody, getNodeDetailQueryParams, getNodesQueryParams, getTdPythonClassDetailsParams, updateNodeBody, } from "../../../gen/mcp/touchDesignerAPI.zod.js";
+import { createNodeBody, deleteNodeQueryParams, execNodeMethodBody, execPythonScriptBody, getModuleHelpQueryParams, getNodeDetailQueryParams, getNodeErrorsQueryParams, getNodesQueryParams, getTdPythonClassDetailsParams, updateNodeBody, } from "../../../gen/mcp/touchDesignerAPI.zod.js";
 import { getTouchDesignerToolMetadata } from "../metadata/touchDesignerToolMetadata.js";
-import { formatClassDetails, formatClassList, formatCreateNodeResult, formatDeleteNodeResult, formatExecNodeMethodResult, formatNodeDetails, formatNodeList, formatScriptResult, formatTdInfo, formatToolMetadata, formatUpdateNodeResult, } from "../presenter/index.js";
+import { formatClassDetails, formatClassList, formatCreateNodeResult, formatDeleteNodeResult, formatExecNodeMethodResult, formatModuleHelp, formatNodeDetails, formatNodeErrors, formatNodeList, formatScriptResult, formatTdInfo, formatToolMetadata, formatUpdateNodeResult, } from "../presenter/index.js";
 import { detailOnlyFormattingSchema, formattingOptionsSchema, } from "../types.js";
 const execPythonScriptToolSchema = execPythonScriptBody.extend(detailOnlyFormattingSchema.shape);
 const tdInfoToolSchema = detailOnlyFormattingSchema;
 const getNodesToolSchema = getNodesQueryParams.extend(formattingOptionsSchema.shape);
 const getNodeDetailToolSchema = getNodeDetailQueryParams.extend(formattingOptionsSchema.shape);
+const getNodeErrorsToolSchema = getNodeErrorsQueryParams.extend(formattingOptionsSchema.shape);
 const createNodeToolSchema = createNodeBody.extend(detailOnlyFormattingSchema.shape);
 const updateNodeToolSchema = updateNodeBody.extend(detailOnlyFormattingSchema.shape);
 const deleteNodeToolSchema = deleteNodeQueryParams.extend(detailOnlyFormattingSchema.shape);
 const classListToolSchema = formattingOptionsSchema;
 const classDetailToolSchema = getTdPythonClassDetailsParams.extend(formattingOptionsSchema.shape);
+const moduleHelpToolSchema = getModuleHelpQueryParams.extend(detailOnlyFormattingSchema.shape);
 const execNodeMethodToolSchema = execNodeMethodBody.extend(detailOnlyFormattingSchema.shape);
 const describeToolsSchema = detailOnlyFormattingSchema.extend({
     filter: z
@@ -38,22 +40,22 @@ export function registerTdTools(server, logger, tdClient) {
                 return {
                     content: [
                         {
-                            type: "text",
                             text: message,
+                            type: "text",
                         },
                     ],
                 };
             }
             const formattedText = formatToolMetadata(filteredEntries, {
                 detailLevel: detailLevel ?? (filter ? "summary" : "minimal"),
-                responseFormat,
                 filter: normalizedFilter,
+                responseFormat,
             });
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -76,8 +78,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -89,7 +91,10 @@ export function registerTdTools(server, logger, tdClient) {
     server.tool(TOOL_NAMES.EXECUTE_PYTHON_SCRIPT, "Execute a Python script in TouchDesigner (detailLevel=minimal|summary|detailed, responseFormat=json|yaml|markdown)", execPythonScriptToolSchema.strict().shape, async (params) => {
         try {
             const { detailLevel, responseFormat, ...scriptParams } = params;
-            logger.debug(`Executing script: ${scriptParams.script}`);
+            logger.sendLog({
+                data: `Executing script: ${scriptParams.script}`,
+                level: "debug",
+            });
             const result = await tdClient.execPythonScript(scriptParams);
             if (!result.success) {
                 throw result.error;
@@ -102,8 +107,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -126,8 +131,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -150,8 +155,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -179,8 +184,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -205,8 +210,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -215,6 +220,31 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODE_PARAMETERS, REFERENCE_COMMENT);
         }
     });
+    server.tool(TOOL_NAMES.GET_TD_NODE_ERRORS, "Check node and descendant errors reported by TouchDesigner", getNodeErrorsToolSchema.strict().shape, async (params) => {
+        try {
+            const { detailLevel, limit, responseFormat, ...queryParams } = params;
+            const result = await tdClient.getNodeErrors(queryParams);
+            if (!result.success) {
+                throw result.error;
+            }
+            const formattedText = formatNodeErrors(result.data, {
+                detailLevel: detailLevel ?? "summary",
+                limit,
+                responseFormat,
+            });
+            return {
+                content: [
+                    {
+                        text: formattedText,
+                        type: "text",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODE_ERRORS, REFERENCE_COMMENT);
+        }
+    });
     server.tool(TOOL_NAMES.UPDATE_TD_NODE_PARAMETERS, "Update parameters of a specific node in TouchDesigner", updateNodeToolSchema.strict().shape, async (params) => {
         try {
             const { detailLevel, responseFormat, ...updateParams } = params;
@@ -229,8 +259,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -247,18 +277,21 @@ export function registerTdTools(server, logger, tdClient) {
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatExecNodeMethodResult(result.data, { nodePath, method, args, kwargs }, { detailLevel: detailLevel ?? "summary", responseFormat });
+            const formattedText = formatExecNodeMethodResult(result.data, { args, kwargs, method, nodePath }, { detailLevel: detailLevel ?? "summary", responseFormat });
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
         }
         catch (error) {
-            logger.error(error);
+            logger.sendLog({
+                data: error,
+                level: "error",
+            });
             return handleToolError(error, logger, TOOL_NAMES.EXECUTE_NODE_METHOD, REFERENCE_COMMENT);
         }
     });
@@ -277,8 +310,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -303,8 +336,8 @@ export function registerTdTools(server, logger, tdClient) {
             return {
                 content: [
                     {
-                        type: "text",
                         text: formattedText,
+                        type: "text",
                     },
                 ],
             };
@@ -313,6 +346,30 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_CLASS_DETAILS, REFERENCE_COMMENT);
         }
     });
+    server.tool(TOOL_NAMES.GET_TD_MODULE_HELP, "Retrieve Python help() text for a TouchDesigner module or class", moduleHelpToolSchema.strict().shape, async (params) => {
+        try {
+            const { detailLevel, moduleName, responseFormat } = params;
+            const result = await tdClient.getModuleHelp({ moduleName });
+            if (!result.success) {
+                throw result.error;
+            }
+            const formattedText = formatModuleHelp(result.data, {
+                detailLevel: detailLevel ?? "summary",
+                responseFormat,
+            });
+            return {
+                content: [
+                    {
+                        text: formattedText,
+                        type: "text",
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return handleToolError(error, logger, TOOL_NAMES.GET_TD_MODULE_HELP);
+        }
+    });
 }
 function matchesMetadataFilter(entry, keyword) {
     const normalizedKeyword = keyword.toLowerCase();