mcp-ts-template 1.6.0 → 1.6.2

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.13.0-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.6.0-blue.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/Version-1.6.2-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)

package/dist/config/index.d.ts

@@ -31,7 +31,7 @@ export declare const config: {
     /** Logging level. From `MCP_LOG_LEVEL` env var. Default: "debug". */
     logLevel: string;
     /** Absolute path to the logs directory. From `LOGS_DIR` env var. */
-    logsPath: string;
+    logsPath: string | null;
     /** Runtime environment. From `NODE_ENV` env var. Default: "development". */
     environment: string;
     /** MCP transport type ('stdio' or 'http'). From `MCP_TRANSPORT_TYPE` env var. Default: "stdio". */

package/dist/config/index.js

@@ -224,12 +224,21 @@ const ensureDirectory = (dirPath, rootDir, dirName) => {
 };
 // --- End Directory Ensurance Function ---
 // --- Logs Directory Handling ---
-const validatedLogsPath = ensureDirectory(env.LOGS_DIR, projectRoot, "logs");
+let validatedLogsPath = ensureDirectory(env.LOGS_DIR, projectRoot, "logs");
 if (!validatedLogsPath) {
     if (process.stdout.isTTY) {
-        console.error("FATAL: Logs directory configuration is invalid or could not be created. Please check permissions and path. Exiting.");
+        console.warn(`Warning: Custom logs directory ('${env.LOGS_DIR}') is invalid or outside the project boundary. Falling back to default.`);
+    }
+    // Try again with the absolute default path
+    const defaultLogsDir = path.join(projectRoot, "logs");
+    validatedLogsPath = ensureDirectory(defaultLogsDir, projectRoot, "logs");
+    if (!validatedLogsPath) {
+        if (process.stdout.isTTY) {
+            // This is just a warning now, not fatal.
+            console.warn("Warning: Default logs directory could not be created. File logging will be disabled.");
+        }
+        // Do not exit. validatedLogsPath remains null, and the logger will handle it.
     }
-    process.exit(1); // Exit if logs directory is not usable
 }
 // --- End Logs Directory Handling ---
 /**

package/dist/utils/internal/logger.js

@@ -35,9 +35,8 @@ const mcpToWinstonLevel = {
     alert: "error",
     emerg: "error",
 };
-// The logsPath from config is already resolved and validated by src/config/index.ts
-const resolvedLogsDir = config.logsPath;
-const isLogsDirSafe = !!resolvedLogsDir; // If logsPath is set, it's considered safe by config logic.
+// The logsPath from config is resolved and validated by src/config/index.ts.
+// It can be null if the directory is invalid or inaccessible, in which case file logging will be disabled.
 /**
  * Creates the Winston console log format.
  * @returns The Winston log format for console output.
@@ -107,10 +106,7 @@ export class Logger {
         this.initialized = true;
         this.currentMcpLevel = level;
         this.currentWinstonLevel = mcpToWinstonLevel[level];
-        // The logs directory (config.logsPath / resolvedLogsDir) is expected to be created and validated
-        // by the configuration module (src/config/index.ts) before logger initialization.
-        // If isLogsDirSafe is true, we assume resolvedLogsDir exists and is usable.
-        // No redundant directory creation logic here.
+        const resolvedLogsDir = config.logsPath;
         const fileFormat = winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.json());
         const transports = [];
         const fileTransportOptions = {
@@ -119,7 +115,7 @@ export class Logger {
             maxFiles: this.LOG_MAX_FILES,
             tailable: true,
         };
-        if (isLogsDirSafe) {
+        if (resolvedLogsDir) {
             transports.push(new winston.transports.File({
                 filename: path.join(resolvedLogsDir, "error.log"),
                 level: "error",
@@ -152,7 +148,7 @@ export class Logger {
             exitOnError: false,
         });
         // Initialize a separate logger for structured interactions
-        if (isLogsDirSafe) {
+        if (resolvedLogsDir) {
             this.interactionLogger = winston.createLogger({
                 format: winston.format.combine(winston.format.timestamp(), winston.format.json({ space: 2 })),
                 transports: [
@@ -179,7 +175,7 @@ export class Logger {
             loggerSetup: true,
             requestId: "logger-post-init",
             timestamp: new Date().toISOString(),
-            logsPathUsed: resolvedLogsDir,
+            logsPathUsed: resolvedLogsDir ?? "none",
         });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-ts-template",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Jumpstart Model Context Protocol (MCP) development with this production-ready TypeScript template. Build robust MCP servers and clients with built-in utilities, authentication, and service integrations. Agent framework utilizing MCP Client included.",
   "main": "dist/index.js",
   "files": [
@@ -36,19 +36,19 @@
     "db:duckdb-example": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js"
   },
   "dependencies": {
-    "@duckdb/node-api": "^1.3.1-alpha.22",
-    "@hono/node-server": "^1.14.4",
-    "@modelcontextprotocol/sdk": "^1.13.1",
-    "@supabase/supabase-js": "^2.50.1",
-    "@types/node": "^24.0.3",
+    "@duckdb/node-api": "^1.3.1-alpha.23",
+    "@hono/node-server": "^1.15.0",
+    "@modelcontextprotocol/sdk": "^1.15.0",
+    "@supabase/supabase-js": "^2.50.3",
+    "@types/node": "^24.0.10",
     "@types/sanitize-html": "^2.16.0",
     "@types/validator": "13.15.2",
     "chrono-node": "^2.8.0",
-    "dotenv": "^16.5.0",
-    "hono": "^4.8.2",
+    "dotenv": "^16.6.1",
+    "hono": "^4.8.4",
     "ignore": "^7.0.5",
     "jose": "^6.0.11",
-    "openai": "^5.7.0",
+    "openai": "^5.8.2",
     "partial-json": "^0.1.7",
     "sanitize-html": "^2.17.0",
     "tiktoken": "^1.0.21",
@@ -57,8 +57,9 @@
     "validator": "13.15.15",
     "winston": "^3.17.0",
     "winston-transport": "^4.9.0",
-    "node-cron": "^4.1.1",
-    "zod": "^3.25.67"
+    "node-cron": "^4.2.0",
+    "zod": "^3.25.74",
+    "js-yaml": "^4.1.0"
   },
   "keywords": [
     "typescript",
@@ -104,8 +105,7 @@
     "@types/node-cron": "^3.0.11",
     "axios": "^1.10.0",
     "depcheck": "^1.4.7",
-    "js-yaml": "^4.1.0",
-    "prettier": "^3.6.0",
-    "typedoc": "^0.28.5"
+    "prettier": "^3.6.2",
+    "typedoc": "^0.28.7"
   }
 }