touchdesigner-mcp-server 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 sadao komaki
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,211 @@
+# TouchDesigner MCP
+
+TouchDesignerのためのMCP(Model Context Protocol) サーバー実装です。AIエージェントがTouchDesignerプロジェクトを制御・操作できるようになることを目指しています。
+
+## 概要
+
+![スクリーンショット 2025-04-14 21 45 47](https://github.com/user-attachments/assets/b7130ebe-406c-4e05-9efc-5d493eb800cb)
+
+TouchDesigner MCPは、AIモデルとTouchDesigner WebServer DAT 間のブリッジとして機能し、AIエージェントが以下のことが可能になります
+- ノードの作成、変更、削除
+- ノードプロパティやプロジェクト構造の照会
+- PythonスクリプトによるTouchDesignerのプログラム的制御
+
+## 前提条件
+
+- Node.js（最新のLTSバージョンを推奨）
+- TouchDesigner（最新の安定版を推奨）
+- Docker（Pythonサーバーコードの生成に必要）
+
+## MCPサーバーコードのビルド
+
+1. リポジトリのクローン
+```bash
+git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+```
+
+2. 依存パッケージのインストール
+```bash
+cd touchdesigner-mcp
+npm install
+```
+3. 環境設定ファイルの設置とビルド
+```
+# テンプレートをコピーし、必要に応じて TD_WEB_SERVER_URL を調整してください
+cp dotenv .env
+
+# プロジェクトのビルド（APIクライアント/サーバー向けスキーマを生成し、MCPリソースをコンパイルします）
+# このコマンドを実行する前にDockerデーモンが実行されていることを確認してください
+npm run build
+```
+
+## 使い方
+
+### TouchDesignerのセットアップ
+
+1.  **コード生成:**
+[MCPサーバーコードのビルド](#MCPサーバーコードのビルド) を参考に、プロジェクトルートで `npm run build` を実行します。これにより以下のコードが生成されます。
+- MCPサーバコード
+- TouchDesigner WebSever DAT向けのAPIサーバーコード
+2.  **TouchDesigner に MCPサーバー向けWebServerをインポートする:**
+TouchDesignerを起動し、`td/mcp_webserver_base.tox` コンポーネントをTouchDesignerプロジェクト直下にimportします。
+tox のimport により `td/import_modules.py` スクリプトが動作し、APIサーバのコントローラなどのモジュールがロードされます。
+
+3.  **APIサーバの動作確認:**
+`td/modules` ディレクトリ内のPythonモジュールが `mcp_webserver_base` コンポーネントからアクセス可能であることを確認します。
+`npm run test` を実行することでMCPサーバーコードのユニットテストと TouchDesigner への結合テストが実行されます。
+TOuchDesigner のメニューから Textportを起動すると通信のログを確認することができます。
+
+*TIPS*
+`mcp_webserver_base.tox` には、MCPサーバーとTouchDesignerを連携させるように設定された WebServer DAT が含まれています。
+このDATがActiveであり、`.env` ファイルの `TD_WEB_SERVER_URL` で指定されたポートで実行されていることを確認してください。（デフォルト: `9981`）
+実行するポートを任意のものに変更したい場合は、以下の手順に従ってください。
+1. `.env` ファイルの `TD_WEB_SERVER_PORT` を変更
+2. `npm run build` を再実行
+3. mcp_webserver_base (WebServer DAT) のポートを変更し、WebServer DATをRestart
+
+### MCP対応 AIエージェントとの接続
+
+TouchDesignerが起動した状態で、AIエージェント（Cursor, Claude Desktop, VSCode CopilotChatなど）をMCPサーバーに接続するように設定します。
+
+```json
+// 設定例（例：VS Code settings.json の Copilot Chat 用）
+"github.copilot.advanced": {
+    "touchdesigner": {
+        "command": "node",
+        "args": [
+            "/path/to/your/touchdesigner-mcp/dist/index.js", // <-- npm run buildによって生成された dist/index.js への絶対パスに置き換えてください
+            "--stdio"
+        ],
+        "transportType": "stdio"
+    }
+}
+```
+
+TouchDesigner で APIサーバーが実行されていれば、エージェントは提供された TouchDesigner ツールを通じてTouchDesignerを使用できます。
+
+## セットアップ後のプロジェクト構造概要
+
+```
+├── src/                       # MCPサーバー ソースコード
+│   ├── api/                  # TD WebServerに対するOpenAPI仕様
+│   ├── core/                 # コアユーティリティ (ロガー, エラーハンドリング)
+│   ├── features/             # MCP機能実装
+│   │   ├── prompts/         # プロンプトハンドラ
+│   │   ├── resources/       # リソースハンドラ
+│   │   └── tools/           # ツールハンドラ (例: tdTools.ts)
+│   ├── gen/                  # OpenAPIスキーマから生成されたMCPサーバー向けコード
+│   ├── server/               # MCPサーバーロジック (接続, メインサーバークラス)
+│   ├── tdClient/             # TD接続API用クライアント
+│   ├── index.ts              # Node.jsサーバーのメインエントリーポイント
+│   └── ...
+├── td/                        # TouchDesigner関連ファイル
+│   ├── modules/              # TouchDesigner用Pythonモジュール
+│   │   ├── mcp/              # TD内でMCPからのリクエストを処理するコアロジック
+│   │   │   ├── controllers/ # APIリクエストコントローラ (api_controller.py, generated_handlers.py)
+│   │   │   └── services/    # ビジネスロジック (api_service.py)
+│   │   ├── td_server/        # OpenAPIスキーマから生成されたPythonモデルコード
+│   │   └── utils/            # 共有Pythonユーティリティ
+│   ├── templates/             # Pythonコード生成用Mustacheテンプレート
+│   ├── genHandlers.js         # generated_handlers.py 生成用のNode.jsスクリプト
+│   ├── import_modules.py      # TDへ APIサーバ関連モジュールをインポートするヘルパースクリプト
+│   └── mcp_webserver_base.tox # メインTouchDesignerコンポーネント
+├── tests/                      # テストコード
+│   ├── integration/
+│   └── unit/
+├── .env                        # ローカル環境変数 (git無視)
+├── dotenv                      # .env用テンプレート
+└── orval.config.ts             # Orval 設定 (TSクライアント生成)
+```
+
+## MCPサーバーの機能
+
+このサーバーは、Model Context Protocol (MCP) を通じてTouchDesigner への操作、および各種実装ドキュメントへの参照を可能にします。
+
+### ツール (Tools)
+
+ツールは、AIエージェントがTouchDesignerでアクションを実行できるようにします。
+
+| ツール名                    | 説明                                           |
+| :-------------------------- | :--------------------------------------------- |
+| `create_td_node`            | 新しいノードを作成します。                     |
+| `delete_td_node`            | 既存のノードを削除します。                     |
+| `exec_node_method`| ノードに対しPythonメソッドを呼び出します。       |
+| `execute_python_script`     | TD内で任意のPythonスクリプトを実行します。     |
+| `get_td_class_details`      | TD Pythonクラス/モジュールの詳細情報を取得します。 |
+| `get_td_classes`            | TouchDesigner Pythonクラスのリストを取得します。 |
+| `get_td_info`           | TDサーバー環境に関する情報を取得します。       |
+| `get_td_node_parameters`    | 特定ノードのパラメータを取得します。           |
+| `get_td_nodes`              | 親パス内のノードを取得します（オプションでフィルタリング）。 |
+| `update_td_node_parameters` | 特定ノードのパラメータを更新します。           |
+
+### プロンプト (Prompts)
+
+プロンプトは、AIエージェントがTouchDesignerで特定のアクションを実行するための指示を提供します。
+
+| プロンプト名                | 説明                                           |
+| :-------------------------- | :--------------------------------------------- |
+| `Search node`               | ノードをファジー検索し、指定されたノード名、ファミリー、タイプに基づいて情報を取得します。 |
+| `Node connection`          | TouchDesigner内でノード同士を接続するための指示を提供します。 |
+| `Check node errors`               | 指定されたノードのエラーをチェックします。子ノードがあれば再帰的にチェックします。           |
+
+### リソース (Resources)
+
+未実装
+
+## 開発
+
+### 開発環境のセットアップ
+
+```bash
+# 依存関係のインストール
+npm install
+
+# リンターと型チェッカーの実行
+npm run lint
+
+# テストの実行
+npm test
+
+# デバッグ用にMCP Inspectorを使用してサーバーを起動
+npm run dev
+```
+
+### APIコード生成ワークフロー
+
+このプロジェクトでは、OpenAPIによるコード生成ツール ( Orval / openapi-generator-cli )を使用しています：
+
+**API定義:** Node.js MCPサーバーとTouchDesigner内で実行されるPythonサーバー間のAPI規約は `src/api/index.yml` で定義されます。
+
+1.  **Pythonサーバー生成 (`npm run gen:webserver`):**
+    *   Docker経由で `openapi-generator-cli` を使用します。
+    *   `src/api/index.yml` を読み取ります。
+    *   API定義に基づいてPythonサーバーのスケルトン (`td/modules/td_server/`) を生成します。このコードはWebServer DATを介してTouchDesigner内で実行されます。
+    *   **Dockerがインストールされ、実行されている必要があります。**
+2.  **Pythonハンドラ生成 (`npm run gen:handlers`):**
+    *   カスタムNode.jsスクリプト (`td/genHandlers.js`) とMustacheテンプレート (`td/templates/`) を使用します。
+    *   生成されたPythonサーバーコードまたはOpenAPI仕様を読み取ります。
+    *   `td/modules/mcp/services/api_service.py` にあるビジネスロジックに接続するハンドラ実装 (`td/modules/mcp/controllers/generated_handlers.py`) を生成します。
+3.  **TypeScriptクライアント生成 (`npm run gen:mcp`):**
+    *   `Orval` を使用し `openapi-generator-cli` がバンドルしたスキーマYAMLからAPIクライアントコードとToolの検証に用いるZodスキーマを生成します。
+    *   Node.jsサーバーが WebServerDAT にリクエストを行うために使用する、型付けされたTypeScriptクライアント (`src/tdClient/`) を生成します。
+
+ビルドプロセス (`npm run build`) は、必要なすべての生成ステップ (`npm run gen`) を実行し、その後にTypeScriptコンパイル (`tsc`) を行います。
+
+## 貢献
+
+貢献は歓迎します！貢献方法は以下の通りです：
+
+1. リポジトリをフォーク
+2. 機能ブランチを作成（`git checkout -b feature/amazing-feature`）
+3. 変更を加える
+4. テストを追加し、すべてが正常に動作することを確認（`npm test`）
+5. 変更をコミット（`git commit -m 'Add some amazing feature'`）
+6. ブランチにプッシュ（`git push origin feature/amazing-feature`）
+7. プルリクエストを開く
+
+プロジェクトのコーディング標準に従い、適切なテストを含めてください。
+
+## ライセンス
+
+MIT

package/README.md

@@ -0,0 +1,204 @@
+# TouchDesigner MCP
+
+TouchDesigner MCP is an implementation of the Model Context Protocol (MCP) server for TouchDesigner, aiming to enable AI agents to control and interact with TouchDesigner projects.
+
+## Overview
+
+![スクリーンショット 2025-04-14 21 45 47](https://github.com/user-attachments/assets/b7130ebe-406c-4e05-9efc-5d493eb800cb)
+
+TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebServer DAT, allowing AI agents to:
+- Create, modify, and delete nodes
+- Query node properties and project structure
+- Programmatically control TouchDesigner using Python scripts
+
+## Prerequisites
+
+- Node.js (latest LTS version recommended)
+- TouchDesigner (latest stable version recommended)
+- Docker (Required for generating Python server code)
+
+## Building the MCP Server Code
+
+1. Clone the repository:
+```bash
+git clone https://github.com/8beeeaaat/touchdesigner-mcp.git
+```
+
+2. Install dependencies:
+```bash
+cd touchdesigner-mcp
+npm install
+```
+
+3. Set up environment configuration and build:
+```bash
+# Copy the template and adjust TD_WEB_SERVER_URL if needed
+cp dotenv .env
+
+# Build the project (Generates API clients/servers and compiles MCP resources)
+# Ensure Docker daemon is running before executing this command
+npm run build
+```
+
+## Usage
+
+### Setting Up TouchDesigner
+
+1.  **Generate Code:**
+Refer to [Building the MCP Server Code](#building-the-mcp-server-code) and run `npm run build` in the project root. This generates:
+- MCP server code
+- API server code for the TouchDesigner WebServer DAT
+
+2.  **Import MCP WebServer into TouchDesigner:**
+Launch TouchDesigner and import the `td/mcp_webserver_base.tox` component into your TouchDesigner project. The import triggers the `td/import_modules.py` script, which loads modules such as API server controllers.
+
+3.  **Verify API Server:**
+Ensure that the Python modules in the `td/modules` directory are accessible from the `mcp_webserver_base` component. Run `npm run test` to execute unit tests for the MCP server code and integration tests with TouchDesigner. You can view communication logs by opening the Textport from the TouchDesigner menu.
+
+*TIPS*
+The `mcp_webserver_base.tox` includes a WebServer DAT configured to integrate the MCP server with TouchDesigner. Ensure this DAT is active and running on the port specified in the `.env` file's `TD_WEB_SERVER_URL` (default: `9981`). To change the port:
+1. Update `TD_WEB_SERVER_PORT` in the `.env` file.
+2. Rebuild the project with `npm run build`.
+3. Update the port in the WebServer DAT and restart it.
+
+### Connecting to an MCP-Compatible AI Agent
+
+With TouchDesigner running, configure an AI agent (e.g., Cursor, Claude Desktop, VSCode CopilotChat) to connect to the MCP server.
+
+```json
+// Example configuration (e.g., in VS Code settings.json for Copilot Chat)
+"github.copilot.advanced": {
+    "touchdesigner": {
+        "command": "node",
+        "args": [
+            "/path/to/your/touchdesigner-mcp/dist/index.js", // <-- Replace with the absolute path generated by npm run build
+            "--stdio"
+        ],
+        "transportType": "stdio"
+    }
+}
+```
+
+Once the API server is running in TouchDesigner, the agent can use the provided TouchDesigner tools.
+
+## Project Structure Overview
+
+```
+├── src/                       # MCP server source code
+│   ├── api/                  # OpenAPI specification for TD WebServer
+│   ├── core/                 # Core utilities (logger, error handling)
+│   ├── features/             # MCP feature implementations
+│   │   ├── prompts/         # Prompt handlers
+│   │   ├── resources/       # Resource handlers
+│   │   └── tools/           # Tool handlers (e.g., tdTools.ts)
+│   ├── gen/                  # Code generated from OpenAPI schema for MCP server
+│   ├── server/               # MCP server logic (connections, main server class)
+│   ├── tdClient/             # Client for TD connection API
+│   ├── index.ts              # Main entry point for the Node.js server
+│   └── ...
+├── td/                        # TouchDesigner-related files
+│   ├── modules/              # Python modules for TouchDesigner
+│   │   ├── mcp/              # Core logic for handling MCP requests in TD
+│   │   │   ├── controllers/ # API request controllers (api_controller.py, generated_handlers.py)
+│   │   │   └── services/    # Business logic (api_service.py)
+│   │   ├── td_server/        # Python model code generated from OpenAPI schema
+│   │   └── utils/            # Shared Python utilities
+│   ├── templates/             # Mustache templates for Python code generation
+│   ├── genHandlers.js         # Node.js script for generating Python handlers
+│   ├── import_modules.py      # Helper script for importing API server modules into TD
+│   └── mcp_webserver_base.tox # Main TouchDesigner component
+├── tests/                      # Test code
+│   ├── integration/
+│   └── unit/
+├── .env                        # Local environment variables (gitignored)
+├── dotenv                      # Template for .env
+└── orval.config.ts             # Orval configuration (TS client generation)
+```
+
+## MCP Server Features
+
+This server enables operations on TouchDesigner via the Model Context Protocol (MCP) and provides access to various tools.
+
+### Tools
+
+| Tool Name                   | Description                                           |
+| :-------------------------- | :--------------------------------------------------- |
+| `create_td_node`            | Creates a new node.                                  |
+| `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 TD.           |
+| `get_td_class_details`      | Retrieves details of TD Python classes/modules.      |
+| `get_td_classes`            | Lists TouchDesigner Python classes.                 |
+| `get_td_info`               | Retrieves information about the TD server environment. |
+| `get_td_node_parameters`    | Retrieves parameters of a specific node.             |
+| `get_td_nodes`              | Retrieves nodes within a parent path (optional filtering). |
+| `update_td_node_parameters` | Updates parameters of a specific node.               |
+
+### Prompts
+
+Prompts allow AI agents to perform specific actions in TouchDesigner.
+
+| Prompt Name                 | Description                                           |
+| :-------------------------- | :--------------------------------------------------- |
+| `Search node`               | Performs a fuzzy search for nodes based on name, family, or type. |
+| `Node connection`           | Provides instructions for connecting nodes in TouchDesigner. |
+| `Check node errors`         | Checks for errors in specified nodes, recursively if child nodes exist. |
+
+### Resources
+
+Not implemented.
+
+## Development
+
+### Setting Up the Development Environment
+
+```bash
+# Install dependencies
+npm install
+
+# Run linters and type checkers
+npm run lint
+
+# Run tests
+npm test
+
+# Start the server with MCP Inspector for debugging
+npm run dev
+```
+
+### API Code Generation Workflow
+
+This project uses OpenAPI-based code generation tools (Orval / openapi-generator-cli):
+
+**API Definition:** The API contract between the Node.js MCP server and the Python server running in TouchDesigner is defined in `src/api/index.yml`.
+
+1.  **Python Server Generation (`npm run gen:webserver`):**
+    *   Uses Docker to run `openapi-generator-cli`.
+    *   Reads `src/api/index.yml`.
+    *   Generates Python server skeleton (`td/modules/td_server/`) for the WebServer DAT in TouchDesigner.
+    *   **Requires Docker to be installed and running.**
+2.  **Python Handler Generation (`npm run gen:handlers`):**
+    *   Uses a custom Node.js script (`td/genHandlers.js`) and Mustache templates (`td/templates/`).
+    *   Generates handler implementations (`td/modules/mcp/controllers/generated_handlers.py`) that connect to business logic in `td/modules/mcp/services/api_service.py`.
+3.  **TypeScript Client Generation (`npm run gen:mcp`):**
+    *   Uses `Orval` to generate a TypeScript client (`src/tdClient/`) for the Node.js server to communicate with the Python server.
+
+The build process (`npm run build`) executes all generation steps (`npm run gen`) and compiles TypeScript (`tsc`).
+
+## Contributing
+
+Contributions are welcome! Follow these steps:
+
+1. Fork the repository.
+2. Create a feature branch (`git checkout -b feature/amazing-feature`).
+3. Make your changes.
+4. Add tests and ensure everything works (`npm test`).
+5. Commit your changes (`git commit -m 'Add some amazing feature'`).
+6. Push to the branch (`git push origin feature/amazing-feature`).
+7. Open a Pull Request.
+
+Ensure your code follows the project's coding standards and includes appropriate tests.
+
+## License
+
+MIT

package/dist/api/customInstance.js

@@ -0,0 +1,18 @@
+import Axios from "axios";
+const API_BASE_URL = process.env.API_BASE_URL || "http://localhost:9981";
+export const AXIOS_INSTANCE = Axios.create({
+    baseURL: API_BASE_URL,
+});
+export const customInstance = (config, options) => {
+    const source = Axios.CancelToken.source();
+    const promise = AXIOS_INSTANCE({
+        ...config,
+        ...options,
+        cancelToken: source.token,
+    }).then(({ data }) => data);
+    // @ts-ignore
+    promise.cancel = () => {
+        source.cancel("Query was cancelled");
+    };
+    return promise;
+};

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/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") });
+/**
+ * Start TouchDesigner MCP server
+ */
+export async function startServer() {
+    const isStdioMode = process.env.NODE_ENV === "cli" || process.argv.includes("--stdio");
+    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 {
+            throw new Error("Sorry, this server is not yet available in the browser. Please use the CLI mode.");
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(`Failed to initialize server: ${errorMessage}`);
+        process.exit(1);
+    }
+}
+if (process.argv[1]) {
+    startServer().catch((error) => {
+        console.error("Failed to start server:", error);
+        process.exit(1);
+    });
+}

package/dist/core/constants.js

@@ -0,0 +1,26 @@
+/**
+ * Reference URLs for TouchDesigner Python documentation
+ */
+export const TD_PYTHON_CLASS_REFERENCE_BASE_URL = "https://docs.derivative.ca";
+export const TD_PYTHON_CLASS_REFERENCE_INDEX_URL = `${TD_PYTHON_CLASS_REFERENCE_BASE_URL}/Python_Classes_and_Modules`;
+/**
+ * Reference Tool Names for TouchDesigner MCP
+ */
+export const TOOL_NAMES = {
+    CREATE_TD_NODE: "create_td_node",
+    DELETE_TD_NODE: "delete_td_node",
+    EXECUTE_PYTHON_SCRIPT: "execute_python_script",
+    EXECUTE_NODE_METHOD: "exec_node_method",
+    GET_TD_INFO: "get_td_info",
+    GET_TD_CLASS_DETAILS: "get_td_class_details",
+    GET_TD_CLASSES: "get_td_classes",
+    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",
+};

package/dist/core/errorHandling.js

@@ -0,0 +1,19 @@
+/**
+ * Handles API errors consistently across the application
+ */
+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 errorMessage = `${toolName}: ${formattedError}${referenceComment ? `. ${referenceComment}` : ""}`;
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: errorMessage,
+            },
+        ],
+    };
+}

package/dist/core/logger.js

@@ -0,0 +1,45 @@
+/**
+ * MCP compatible logger implementation
+ * Handles "Not connected" errors gracefully
+ */
+export class McpLogger {
+    server;
+    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);
+            }
+        }
+    }
+}

package/dist/core/result.js

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