mcp-ts-template 1.4.0 → 1.4.1

package/README.md

@@ -3,7 +3,7 @@
 [![TypeScript](https://img.shields.io/badge/TypeScript-^5.8.3-blue.svg)](https://www.typescriptlang.org/)
 [![Model Context Protocol SDK](https://img.shields.io/badge/MCP%20SDK-1.12.1-green.svg)](https://github.com/modelcontextprotocol/typescript-sdk)
 [![MCP Spec Version](https://img.shields.io/badge/MCP%20Spec-2025--03--26-lightgrey.svg)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-03-26/changelog.mdx)
-[![Version](https://img.shields.io/badge/Version-1.4.0-blue.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/Version-1.4.1-blue.svg)](./CHANGELOG.md)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 [![Status](https://img.shields.io/badge/Status-Stable-green.svg)](https://github.com/cyanheads/mcp-ts-template/issues)
 [![GitHub](https://img.shields.io/github/stars/cyanheads/mcp-ts-template?style=social)](https://github.com/cyanheads/mcp-ts-template)
@@ -18,7 +18,7 @@ Whether you're creating a new MCP server to extend an AI's capabilities or integ
 
 | Feature Area                | Description                                                                                                                                                                  | Key Components / Location                                                      |
 | :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- |
-| **🔌 MCP Server**           | Functional server example with Echo Tool & Resource. Supports `stdio` and **Streamable HTTP** (which utilizes Server-Sent Events for server-to-client streaming) transports. | `src/mcp-server/`                                                              |
+| **🔌 MCP Server**           | Functional server with example tools (`EchoTool`, `CatFactFetcher` for async/Promise API example) and an `EchoResource`. Supports `stdio` and **Streamable HTTP** transports. | `src/mcp-server/`                                                              |
 | **💻 MCP Client**           | Working client aligned with **MCP 2025-03-26 spec**. Connects via `mcp-config.json`. Includes detailed comments.                                                             | `src/mcp-client/`                                                              |
 | **🚀 Production Utilities** | Logging, Error Handling, ID Generation, Rate Limiting, Request Context tracking, Input Sanitization.                                                                         | `src/utils/`                                                                   |
 | **🔒 Type Safety/Security** | Strong type checking via TypeScript & Zod validation. Built-in security utilities (sanitization, auth middleware stub for HTTP).                                             | Throughout, `src/utils/security/`, `src/mcp-server/transports/authentication/` |
@@ -180,8 +180,8 @@ The `src/` directory is organized for clarity:
   - `index.ts`: Barrel file exporting key client functionalities.
 - `mcp-server/`: Logic for the MCP server _provided by this template_.
   - `server.ts`: Initializes the server, registers tools/resources.
-  - `resources/`: Example resource implementations (e.g., EchoResource).
-  - `tools/`: Example tool implementations (e.g., EchoTool).
+  - `resources/`: Example resource implementations (e.g., `EchoResource`).
+  - `tools/`: Example tool implementations (e.g., `EchoTool`, and `CatFactFetcher` demonstrating async/Promise API calls).
   - `transports/`: Handles `stdio` and `http` communication for the server.
 - `services/`: Contains service integrations.
   - `duck-db/`: Service for interacting with DuckDB, an in-process analytical data management system.
@@ -222,6 +222,8 @@ This template is designed for extension! Follow the high-level SDK patterns:
 
 Refer to the included `EchoTool` and `EchoResource` examples and the [.clinerules](.clinerules) cheatsheet for detailed patterns.
 
+For an example of a tool that performs asynchronous operations, such as making an external API call, see the `get_random_cat_fact` tool located in `src/mcp-server/tools/catFactFetcher/`. This tool demonstrates how to use `async/await` within your tool's logic and handler, manage Promises, and integrate external data sources.
+
 ## 🌍 Explore More MCP Resources
 
 Looking for more examples, guides, and pre-built MCP servers? Check out the companion repository:

package/dist/mcp-server/server.js

@@ -18,6 +18,7 @@ import { config, environment } from "../config/index.js";
 import { ErrorHandler, logger, requestContextService } from "../utils/index.js";
 import { registerEchoResource } from "./resources/echoResource/index.js";
 import { registerEchoTool } from "./tools/echoTool/index.js";
+import { registerCatFactFetcherTool } from "./tools/catFactFetcher/index.js";
 import { startHttpTransport } from "./transports/httpTransport.js";
 import { connectStdioTransport } from "./transports/stdioTransport.js";
 /**
@@ -70,6 +71,7 @@ async function createMcpServerInstance() {
         logger.debug("Registering resources and tools...", context);
         await registerEchoResource(server);
         await registerEchoTool(server);
+        await registerCatFactFetcherTool(server);
         logger.info("Resources and tools registered successfully", context);
     }
     catch (err) {

package/dist/mcp-server/tools/catFactFetcher/catFactFetcherLogic.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `get_random_cat_fact` tool.
+ * This tool fetches a random cat fact from the public Cat Fact Ninja API.
+ * It demonstrates an asynchronous API call within an MCP tool.
+ * @module src/mcp-server/tools/catFactFetcher/catFactFetcherLogic
+ */
+import { z } from "zod";
+import { type RequestContext } from "../../../utils/index.js";
+/**
+ * Zod schema for validating input arguments for the `get_random_cat_fact` tool.
+ */
+export declare const CatFactFetcherInputSchema: z.ZodObject<{
+    maxLength: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxLength?: number | undefined;
+}, {
+    maxLength?: number | undefined;
+}>;
+/**
+ * TypeScript type inferred from `CatFactFetcherInputSchema`.
+ */
+export type CatFactFetcherInput = z.infer<typeof CatFactFetcherInputSchema>;
+/**
+ * Defines the structure of the JSON payload returned by the `get_random_cat_fact` tool handler.
+ */
+export interface CatFactFetcherResponse {
+    fact: string;
+    length: number;
+    requestedMaxLength?: number;
+    timestamp: string;
+}
+/**
+ * Processes the core logic for the `get_random_cat_fact` tool.
+ * It calls the Cat Fact Ninja API and returns the fetched fact.
+ * @param params - The validated input parameters for the tool.
+ * @param context - The request context for logging and tracing.
+ * @returns A promise that resolves to an object containing the cat fact data.
+ */
+export declare const processCatFactFetcher: (params: CatFactFetcherInput, context: RequestContext) => Promise<CatFactFetcherResponse>;

package/dist/mcp-server/tools/catFactFetcher/catFactFetcherLogic.js

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Defines the core logic, schemas, and types for the `get_random_cat_fact` tool.
+ * This tool fetches a random cat fact from the public Cat Fact Ninja API.
+ * It demonstrates an asynchronous API call within an MCP tool.
+ * @module src/mcp-server/tools/catFactFetcher/catFactFetcherLogic
+ */
+import { z } from "zod";
+import { logger, fetchWithTimeout, // Added import
+ } from "../../../utils/index.js";
+import { McpError, BaseErrorCode } from "../../../types-global/errors.js";
+/**
+ * Asynchronously fetches a random cat fact from the Cat Fact Ninja API.
+ * @param maxLength - Optional maximum length for the cat fact.
+ * @param context - The request context for logging.
+ * @returns A promise that resolves to the CatFactApiResponse.
+ * @throws {McpError} If the API request fails or returns an error.
+ */
+async function fetchRandomCatFactFromApi(maxLength, context) {
+    let apiUrl = "https://catfact.ninja/fact";
+    if (maxLength !== undefined) {
+        apiUrl += `?max_length=${maxLength}`;
+    }
+    logger.info(`Fetching random cat fact from: ${apiUrl}`, context);
+    const CAT_FACT_API_TIMEOUT_MS = 5000;
+    try {
+        // Use the fetchWithTimeout utility
+        const response = await fetchWithTimeout(apiUrl, CAT_FACT_API_TIMEOUT_MS, context);
+        if (!response.ok) {
+            const errorText = await response.text();
+            logger.error(`Cat Fact API request to ${apiUrl} failed with status ${response.status}: ${errorText}`, context);
+            throw new McpError(BaseErrorCode.SERVICE_UNAVAILABLE, `Cat Fact API request to ${apiUrl} failed: ${response.status} ${response.statusText}`, {
+                ...context,
+                httpStatusCode: response.status,
+                responseBodyBrief: errorText.substring(0, 200), // Log a snippet of the response
+                errorSource: "CatFactApiNonOkResponse",
+            });
+        }
+        const data = await response.json();
+        logger.info(`Successfully fetched cat fact (length: ${data.length}): "${data.fact.substring(0, 50)}..."`, context);
+        return data;
+    }
+    catch (error) {
+        // The fetchWithTimeout utility handles AbortError and throws McpError with BaseErrorCode.TIMEOUT.
+        // It also wraps other fetch-related network errors in McpError.
+        // So, we primarily need to catch McpErrors here or wrap any truly unexpected errors.
+        if (error instanceof McpError) {
+            // Log McpErrors specifically if needed, or just re-throw
+            // If it's a TIMEOUT error from fetchWithTimeout, it's already logged by the utility.
+            // If it's a SERVICE_UNAVAILABLE from fetchWithTimeout (generic network error), also logged.
+            // If it's from response.ok check above, it's also an McpError.
+            throw error;
+        }
+        // Fallback for any other unexpected errors not already wrapped by McpError
+        logger.error(`Unexpected error during Cat Fact API processing for ${apiUrl}: ${error instanceof Error ? error.message : String(error)}`, context);
+        throw new McpError(BaseErrorCode.INTERNAL_ERROR, // Or UNKNOWN_ERROR if more appropriate
+        `Unexpected error processing response from Cat Fact API (${apiUrl}): ${error instanceof Error ? error.message : String(error)}`, {
+            ...context,
+            originalErrorName: error instanceof Error ? error.name : "UnknownError",
+            errorSource: "CatFactApiUnexpectedCatch",
+        });
+    }
+}
+/**
+ * Zod schema for validating input arguments for the `get_random_cat_fact` tool.
+ */
+export const CatFactFetcherInputSchema = z
+    .object({
+    maxLength: z
+        .number()
+        .int("Max length must be an integer.")
+        .min(1, "Max length must be at least 1.")
+        .optional()
+        .describe("Optional: The maximum character length of the cat fact to retrieve."),
+})
+    .describe("Input schema for the get_random_cat_fact tool. Allows specifying a maximum length for the fact.");
+/**
+ * Processes the core logic for the `get_random_cat_fact` tool.
+ * It calls the Cat Fact Ninja API and returns the fetched fact.
+ * @param params - The validated input parameters for the tool.
+ * @param context - The request context for logging and tracing.
+ * @returns A promise that resolves to an object containing the cat fact data.
+ */
+export const processCatFactFetcher = async (params, context) => {
+    logger.debug("Processing get_random_cat_fact logic with input parameters.", {
+        ...context,
+        toolInput: { maxLength: params.maxLength },
+    });
+    const apiResponse = await fetchRandomCatFactFromApi(params.maxLength, context);
+    const toolResponse = {
+        fact: apiResponse.fact,
+        length: apiResponse.length,
+        requestedMaxLength: params.maxLength,
+        timestamp: new Date().toISOString(),
+    };
+    logger.debug("Random cat fact fetched and processed successfully.", {
+        ...context,
+        toolResponseSummary: {
+            factLength: toolResponse.length,
+            requestedMaxLength: toolResponse.requestedMaxLength,
+        },
+    });
+    return toolResponse;
+};

package/dist/mcp-server/tools/catFactFetcher/catFactFetcherRegistration.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Handles the registration of the `get_random_cat_fact` tool
+ * with an MCP server instance. This tool fetches a random cat fact from the
+ * Cat Fact Ninja API.
+ * @module src/mcp-server/tools/catFactFetcher/catFactFetcherRegistration
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers the 'get_random_cat_fact' tool and its handler with the MCP server.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ * @returns A promise that resolves when tool registration is complete.
+ * @throws {McpError} If registration fails critically.
+ */
+export declare const registerCatFactFetcherTool: (server: McpServer) => Promise<void>;

package/dist/mcp-server/tools/catFactFetcher/catFactFetcherRegistration.js

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Handles the registration of the `get_random_cat_fact` tool
+ * with an MCP server instance. This tool fetches a random cat fact from the
+ * Cat Fact Ninja API.
+ * @module src/mcp-server/tools/catFactFetcher/catFactFetcherRegistration
+ */
+import { BaseErrorCode, McpError } from "../../../types-global/errors.js";
+import { ErrorHandler, logger, requestContextService, } from "../../../utils/index.js";
+import { CatFactFetcherInputSchema, processCatFactFetcher, } from "./catFactFetcherLogic.js";
+/**
+ * Registers the 'get_random_cat_fact' tool and its handler with the MCP server.
+ *
+ * @param server - The MCP server instance to register the tool with.
+ * @returns A promise that resolves when tool registration is complete.
+ * @throws {McpError} If registration fails critically.
+ */
+export const registerCatFactFetcherTool = async (server) => {
+    const toolName = "get_random_cat_fact";
+    const toolDescription = "Fetches a random cat fact from the Cat Fact Ninja API. Optionally, a maximum length for the fact can be specified.";
+    const registrationContext = requestContextService.createRequestContext({
+        operation: "RegisterTool",
+        toolName: toolName,
+        moduleName: "CatFactFetcherRegistration",
+    });
+    logger.info(`Attempting to register tool: '${toolName}'`, registrationContext);
+    await ErrorHandler.tryCatch(async () => {
+        server.tool(toolName, toolDescription, CatFactFetcherInputSchema.shape, // SDK uses this for schema generation & validation
+        async (params) => {
+            const handlerContext = requestContextService.createRequestContext({
+                parentContext: registrationContext,
+                operation: "HandleToolRequest",
+                toolName: toolName,
+                inputSummary: { maxLength: params.maxLength },
+            });
+            logger.debug(`Handling '${toolName}' tool request.`, handlerContext);
+            return await ErrorHandler.tryCatch(async () => {
+                const responsePayload = await processCatFactFetcher(params, handlerContext);
+                logger.debug(`'${toolName}' tool processed successfully. Preparing result.`, handlerContext);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(responsePayload, null, 2),
+                        },
+                    ],
+                    isError: false,
+                };
+            }, {
+                operation: `ExecutingCoreLogicFor_${toolName}`,
+                context: handlerContext,
+                input: params, // Input is sanitized by ErrorHandler for logging
+                errorMapper: (error) => {
+                    // Ensure a specific McpError is created if not already one
+                    if (error instanceof McpError)
+                        return error;
+                    const errorMessage = `Error processing '${toolName}' tool: ${error instanceof Error ? error.message : "An unknown error occurred"}`;
+                    return new McpError(BaseErrorCode.INTERNAL_ERROR, errorMessage, {
+                        ...handlerContext,
+                        originalErrorName: error instanceof Error ? error.name : typeof error,
+                    });
+                },
+            });
+        });
+        logger.info(`Tool '${toolName}' registered successfully with the MCP server.`, registrationContext);
+    }, {
+        operation: `RegisteringTool_${toolName}`,
+        context: registrationContext,
+        errorCode: BaseErrorCode.INITIALIZATION_FAILED,
+        errorMapper: (error) => {
+            if (error instanceof McpError)
+                return error;
+            const errorMessage = `Failed to register tool '${toolName}': ${error instanceof Error ? error.message : "An unknown error occurred during registration."}`;
+            return new McpError(BaseErrorCode.INITIALIZATION_FAILED, errorMessage, {
+                ...registrationContext,
+                originalErrorName: error instanceof Error ? error.name : typeof error,
+            });
+        },
+        critical: true, // Registration failure is critical
+    });
+};

package/dist/mcp-server/tools/catFactFetcher/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel file for the `catFactFetcher` tool.
+ * This file serves as the public interface for the cat fact fetcher tool module,
+ * primarily exporting the `registerCatFactFetcherTool` function.
+ * @module src/mcp-server/tools/catFactFetcher/index
+ */
+export { registerCatFactFetcherTool } from "./catFactFetcherRegistration.js";

package/dist/mcp-server/tools/catFactFetcher/index.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Barrel file for the `catFactFetcher` tool.
+ * This file serves as the public interface for the cat fact fetcher tool module,
+ * primarily exporting the `registerCatFactFetcherTool` function.
+ * @module src/mcp-server/tools/catFactFetcher/index
+ */
+export { registerCatFactFetcherTool } from "./catFactFetcherRegistration.js";

package/dist/services/duck-db/duckDBQueryExecutor.js

@@ -60,9 +60,10 @@ export class DuckDBQueryExecutor {
             else {
                 resultObject = await this.dbConnection.stream(sql, params); // Cast to any for object
             }
-            const rows = await resultObject.getRows(); // Use getRows() as per docs, and it's async
+            const rows = (await resultObject.getRows()); // Use getRows() as per docs, and it's async
             const columnNames = resultObject.columnNames(); // Sync as per docs
-            const columnTypes = resultObject.columnTypes() // Sync as per docs
+            const columnTypes = resultObject
+                .columnTypes() // Sync as per docs
                 .map((ct) => ct.typeId);
             return {
                 rows: rows,

package/dist/storage/duckdbExample.js

@@ -83,7 +83,7 @@ async function runDuckDBExample() {
             { name: "Alice Wonderland", email: "alice@example.com" },
             { name: "Bob The Builder", email: "bob@example.com" },
             { name: "Charlie Chaplin", email: "charlie@example.com" },
-        ].map(user => ({
+        ].map((user) => ({
             id: idGenerator.generateRandomString(6), // Generate 6-digit alphanumeric ID directly
             ...user,
         }));

package/dist/utils/index.d.ts

@@ -8,3 +8,4 @@ export * from "./internal/index.js";
 export * from "./metrics/index.js";
 export * from "./parsing/index.js";
 export * from "./security/index.js";
+export * from "./network/index.js";

package/dist/utils/index.js

@@ -9,6 +9,7 @@ export * from "./internal/index.js";
 export * from "./metrics/index.js";
 export * from "./parsing/index.js";
 export * from "./security/index.js";
+export * from "./network/index.js";
 // It's good practice to have index.ts files in each subdirectory
 // that export the contents of that directory.
 // Assuming those will be created or already exist.

package/dist/utils/internal/logger.js

@@ -61,7 +61,7 @@ function createWinstonConsoleFormat() {
         }
         if (Object.keys(metaCopy).length > 0) {
             try {
-                const replacer = (key, value) => typeof value === 'bigint' ? value.toString() : value;
+                const replacer = (key, value) => typeof value === "bigint" ? value.toString() : value;
                 const remainingMetaJson = JSON.stringify(metaCopy, replacer, 2);
                 if (remainingMetaJson !== "{}")
                     metaString += `\n  Meta: ${remainingMetaJson}`;

package/dist/utils/network/fetchWithTimeout.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Provides a utility function to make fetch requests with a specified timeout.
+ * @module src/utils/network/fetchWithTimeout
+ */
+import type { RequestContext } from "../internal/requestContext.js";
+/**
+ * Options for the fetchWithTimeout utility.
+ * Extends standard RequestInit but omits 'signal' as it's handled internally.
+ */
+export type FetchWithTimeoutOptions = Omit<RequestInit, "signal">;
+/**
+ * Fetches a resource with a specified timeout.
+ *
+ * @param url - The URL to fetch.
+ * @param timeoutMs - The timeout duration in milliseconds.
+ * @param context - The request context for logging.
+ * @param options - Optional fetch options (RequestInit), excluding 'signal'.
+ * @returns A promise that resolves to the Response object.
+ * @throws {McpError} If the request times out or another fetch-related error occurs.
+ */
+export declare function fetchWithTimeout(url: string | URL, timeoutMs: number, context: RequestContext, options?: FetchWithTimeoutOptions): Promise<Response>;

package/dist/utils/network/fetchWithTimeout.js

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Provides a utility function to make fetch requests with a specified timeout.
+ * @module src/utils/network/fetchWithTimeout
+ */
+import { logger } from "../internal/logger.js"; // Adjusted import path
+import { McpError, BaseErrorCode } from "../../types-global/errors.js";
+/**
+ * Fetches a resource with a specified timeout.
+ *
+ * @param url - The URL to fetch.
+ * @param timeoutMs - The timeout duration in milliseconds.
+ * @param context - The request context for logging.
+ * @param options - Optional fetch options (RequestInit), excluding 'signal'.
+ * @returns A promise that resolves to the Response object.
+ * @throws {McpError} If the request times out or another fetch-related error occurs.
+ */
+export async function fetchWithTimeout(url, timeoutMs, context, options) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    const urlString = url.toString();
+    const operationDescription = `fetch ${options?.method || "GET"} ${urlString}`;
+    logger.debug(`Attempting ${operationDescription} with ${timeoutMs}ms timeout.`, context);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        clearTimeout(timeoutId);
+        logger.debug(`Successfully fetched ${urlString}. Status: ${response.status}`, context);
+        return response;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error && error.name === "AbortError") {
+            logger.error(`${operationDescription} timed out after ${timeoutMs}ms.`, {
+                ...context,
+                errorSource: "FetchTimeout",
+            });
+            throw new McpError(BaseErrorCode.TIMEOUT, `${operationDescription} timed out.`, { ...context, errorSource: "FetchTimeout" });
+        }
+        // Log and re-throw other errors as McpError
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        logger.error(`Network error during ${operationDescription}: ${errorMessage}`, {
+            ...context,
+            originalErrorName: error instanceof Error ? error.name : "UnknownError",
+            errorSource: "FetchNetworkError",
+        });
+        if (error instanceof McpError) {
+            // If it's already an McpError, re-throw it
+            throw error;
+        }
+        throw new McpError(BaseErrorCode.SERVICE_UNAVAILABLE, // Generic error for network/service issues
+        `Network error during ${operationDescription}: ${errorMessage}`, {
+            ...context,
+            originalErrorName: error instanceof Error ? error.name : "UnknownError",
+            errorSource: "FetchNetworkErrorWrapper",
+        });
+    }
+}

package/dist/utils/network/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Barrel file for network utilities.
+ * @module src/utils/network/index
+ */
+export * from "./fetchWithTimeout.js";
+export type { FetchWithTimeoutOptions } from "./fetchWithTimeout.js";

package/dist/utils/network/index.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Barrel file for network utilities.
+ * @module src/utils/network/index
+ */
+export * from "./fetchWithTimeout.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-ts-template",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "TypeScript template for building Model Context Protocol (MCP) Servers & Clients. Features extensive utilities (logger, requestContext, etc.), STDIO & Streamable HTTP (with authMiddleware), examples, and type safety. Ideal starting point for creating production-ready MCP Servers & Clients.",
   "main": "dist/index.js",
   "files": [
@@ -30,14 +30,13 @@
     "fetch-spec": "ts-node --esm scripts/fetch-openapi-spec.ts",
     "format": "prettier --write \"**/*.{ts,js,json,md,html,css}\"",
     "inspector": "mcp-inspector --config mcp.json --server mcp-ts-template",
-    "start:client-cli": "node dist/mcp-client/cli/mcp-client-cli.js",
     "db:generate": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js"
   },
   "dependencies": {
     "@duckdb/node-api": "^1.3.0-alpha.21",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "@types/jsonwebtoken": "^9.0.9",
-    "@types/node": "^22.15.28",
+    "@types/node": "^22.15.29",
     "@types/sanitize-html": "^2.16.0",
     "@types/validator": "13.15.1",
     "chalk": "^5.4.1",
@@ -45,7 +44,7 @@
     "cli-table3": "^0.6.5",
     "dotenv": "^16.5.0",
     "express": "^5.1.0",
-    "ignore": "^7.0.4",
+    "ignore": "^7.0.5",
     "jsonwebtoken": "^9.0.2",
     "openai": "^5.0.1",
     "partial-json": "^0.1.7",