mcp-ts-template 2.3.1 → 2.3.3

package/README.md

@@ -5,7 +5,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-2.3.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/mcp-ts-template/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-87.74%25-brightgreen.svg?style=flat-square)](./coverage/lcov-report/)
+[![Version](https://img.shields.io/badge/Version-2.3.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/mcp-ts-template/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-87.74%25-brightgreen.svg?style=flat-square)](./coverage/lcov-report/)
 
 </div>
 
@@ -26,6 +26,24 @@
 
 ## 🚀 Getting Started
 
+### MCP Client Settings/Configuration
+
+Add the following to your MCP Client configuration file (e.g., `cline_mcp_settings.json`).
+
+```json
+{
+  "mcpServers": {
+    "mcp-ts-template": {
+      "command": "bunx",
+      "args": ["mcp-ts-template@latest"],
+      "env": {
+        "MCP_LOG_LEVEL": "info"
+      }
+    }
+  }
+}
+```
+
 ### Prerequisites
 
 - [Bun v1.2.0](https://bun.sh/) or higher.

package/dist/index.js

@@ -117488,55 +117488,10 @@ var z = /* @__PURE__ */ Object.freeze({
   quotelessJson,
   ZodError
 });
-
-// src/types-global/errors.ts
-var JsonRpcErrorCode;
-((JsonRpcErrorCode2) => {
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ParseError"] = -32700] = "ParseError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidRequest"] = -32600] = "InvalidRequest";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["MethodNotFound"] = -32601] = "MethodNotFound";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidParams"] = -32602] = "InvalidParams";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InternalError"] = -32603] = "InternalError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ServiceUnavailable"] = -32000] = "ServiceUnavailable";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["NotFound"] = -32001] = "NotFound";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Conflict"] = -32002] = "Conflict";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["RateLimited"] = -32003] = "RateLimited";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Timeout"] = -32004] = "Timeout";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Forbidden"] = -32005] = "Forbidden";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["Unauthorized"] = -32006] = "Unauthorized";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ValidationError"] = -32007] = "ValidationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["ConfigurationError"] = -32008] = "ConfigurationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["InitializationFailed"] = -32009] = "InitializationFailed";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["DatabaseError"] = -32010] = "DatabaseError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["SerializationError"] = -32070] = "SerializationError";
-  JsonRpcErrorCode2[JsonRpcErrorCode2["UnknownError"] = -32099] = "UnknownError";
-})(JsonRpcErrorCode ||= {});
-
-class McpError extends Error {
-  code;
-  data;
-  constructor(code, message, data, options) {
-    super(message, options);
-    this.code = code;
-    if (data) {
-      this.data = data;
-    }
-    this.name = "McpError";
-    Object.setPrototypeOf(this, McpError.prototype);
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, McpError);
-    }
-  }
-}
-var ErrorSchema = z.object({
-  code: z.nativeEnum(JsonRpcErrorCode).describe("Standardized error code from JsonRpcErrorCode enum"),
-  message: z.string().min(1, "Error message cannot be empty.").describe("Detailed human-readable error message"),
-  data: z.record(z.string(), z.unknown()).optional().describe("Optional structured data providing more context about the error")
-}).describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
 // package.json
 var package_default = {
   name: "mcp-ts-template",
-  version: "2.3.0",
+  version: "2.3.3",
   mcpName: "io.github.cyanheads/mcp-ts-template",
   description: "The definitive, production-grade template for building powerful and scalable Model Context Protocol (MCP) servers with TypeScript, featuring built-in observability (OpenTelemetry), declarative tooling, robust error handling, and a modular, DI-driven architecture.",
   main: "dist/index.js",
@@ -117567,30 +117522,27 @@ var package_default = {
   scripts: {
     build: "bun build ./src/index.ts --outdir ./dist --target node",
     "build:worker": "bun build ./src/worker.ts --outdir ./dist --target bun --no-external",
-    "deploy:dev": "bunx wrangler dev",
-    "deploy:prod": "bunx wrangler deploy",
+    "deploy:dev": "MCP_TRANSPORT_TYPE=http bunx wrangler dev",
+    "deploy:prod": "MCP_TRANSPORT_TYPE=http bunx wrangler deploy",
     start: "bun ./dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
-    "start:agent": "MCP_LOG_LEVEL=debug bun ./dist/agent/cli/boot.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
     dev: "bun --watch src/index.ts",
     "dev:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
     "dev:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
-    "dev:agent": "MCP_LOG_LEVEL=debug bun --watch src/agent/cli/boot.ts",
     devdocs: "bun run scripts/devdocs.ts",
     devcheck: "bun run scripts/devcheck.ts",
     rebuild: "bun run scripts/clean.ts && bun run build",
-    "docs:generate": "typedoc",
+    "docs:generate": "bunx typedoc",
     depcheck: "bunx depcheck",
-    lint: "eslint .",
-    "lint:fix": "eslint . --fix",
-    typecheck: "tsc --noEmit",
+    lint: "bunx eslint .",
+    "lint:fix": "bunx eslint . --fix",
+    typecheck: "bunx tsc --noEmit",
     tree: "bun run scripts/tree.ts",
     "fetch-spec": "bun run scripts/fetch-openapi-spec.ts",
-    format: 'bun run prettier --write "**/*.{ts,js,json,md,html,css}"',
-    prepare: "[ -d .husky ] && husky || true",
+    format: 'bunx prettier --write "**/*.{ts,js,json,md,html,css}"',
+    prepare: "bunx husky",
     inspector: "bunx mcp-inspector --config mcp.json --server mcp-ts-template",
-    "db:duckdb-example": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js",
     test: "bun test --config vitest.config.ts",
     "test:coverage": "bun test --coverage",
     audit: "bun audit",
@@ -117619,22 +117571,19 @@ var package_default = {
     jose: "^6.1.0",
     "js-yaml": "^4.1.0",
     "node-cron": "^4.2.1",
-    openai: "^6.0.0",
+    openai: "^6.0.1",
     papaparse: "^5.5.3",
     "partial-json": "^0.1.7",
     "pdf-lib": "^1.17.1",
     pino: "^9.12.0",
+    "pino-pretty": "^13.1.1",
     "reflect-metadata": "^0.2.2",
     repomix: "^1.6.0",
     "sanitize-html": "^2.17.0",
     tslib: "^2.8.1",
     tsyringe: "^4.10.0",
     validator: "13.15.15",
-    zod: "^3.23.8"
-  },
-  devDependencies: {
-    "@cloudflare/workers-types": "^4.20250927.0",
-    "@eslint/js": "^9.36.0",
+    zod: "^3.23.8",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/auto-instrumentations-node": "^0.64.6",
     "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
@@ -117644,10 +117593,14 @@ var package_default = {
     "@opentelemetry/sdk-metrics": "^2.1.0",
     "@opentelemetry/sdk-node": "^0.205.0",
     "@opentelemetry/sdk-trace-node": "^2.1.0",
-    "@opentelemetry/semantic-conventions": "^1.37.0",
+    "@opentelemetry/semantic-conventions": "^1.37.0"
+  },
+  devDependencies: {
+    "@cloudflare/workers-types": "^4.20251001.0",
+    "@eslint/js": "^9.36.0",
     "@types/bun": "^1.2.23",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.6.0",
+    "@types/node": "^24.6.2",
     "@types/node-cron": "^3.0.11",
     "@types/papaparse": "^5.3.16",
     "@types/sanitize-html": "^2.16.0",
@@ -117663,12 +117616,11 @@ var package_default = {
     globals: "^16.4.0",
     husky: "^9.1.7",
     msw: "^2.11.3",
-    "pino-pretty": "^13.1.1",
     prettier: "^3.6.2",
     typedoc: "^0.28.13",
-    typescript: "^5.9.3",
+    typescript: "^5.9.2",
     "typescript-eslint": "8.45.0",
-    vite: "^7.1.7",
+    vite: "^7.1.8",
     "vite-tsconfig-paths": "^5.1.4",
     vitest: "^3.2.4"
   },
@@ -117721,6 +117673,51 @@ var package_default = {
   }
 };
 
+// src/types-global/errors.ts
+var JsonRpcErrorCode;
+((JsonRpcErrorCode2) => {
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ParseError"] = -32700] = "ParseError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidRequest"] = -32600] = "InvalidRequest";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["MethodNotFound"] = -32601] = "MethodNotFound";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InvalidParams"] = -32602] = "InvalidParams";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InternalError"] = -32603] = "InternalError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ServiceUnavailable"] = -32000] = "ServiceUnavailable";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["NotFound"] = -32001] = "NotFound";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Conflict"] = -32002] = "Conflict";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["RateLimited"] = -32003] = "RateLimited";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Timeout"] = -32004] = "Timeout";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Forbidden"] = -32005] = "Forbidden";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["Unauthorized"] = -32006] = "Unauthorized";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ValidationError"] = -32007] = "ValidationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["ConfigurationError"] = -32008] = "ConfigurationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["InitializationFailed"] = -32009] = "InitializationFailed";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["DatabaseError"] = -32010] = "DatabaseError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["SerializationError"] = -32070] = "SerializationError";
+  JsonRpcErrorCode2[JsonRpcErrorCode2["UnknownError"] = -32099] = "UnknownError";
+})(JsonRpcErrorCode ||= {});
+
+class McpError extends Error {
+  code;
+  data;
+  constructor(code, message, data, options) {
+    super(message, options);
+    this.code = code;
+    if (data) {
+      this.data = data;
+    }
+    this.name = "McpError";
+    Object.setPrototypeOf(this, McpError.prototype);
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, McpError);
+    }
+  }
+}
+var ErrorSchema = z.object({
+  code: z.nativeEnum(JsonRpcErrorCode).describe("Standardized error code from JsonRpcErrorCode enum"),
+  message: z.string().min(1, "Error message cannot be empty.").describe("Detailed human-readable error message"),
+  data: z.record(z.string(), z.unknown()).optional().describe("Optional structured data providing more context about the error")
+}).describe("Schema for validating structured error objects, ensuring consistency in error reporting.");
+
 // src/config/index.ts
 var packageManifest = package_default;
 var hasFileSystemAccess = typeof process !== "undefined" && typeof process.versions === "object" && process.versions !== null && typeof process.versions.node === "string";
@@ -119784,7 +119781,7 @@ var safeJSON = (text) => {
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
 // node_modules/openai/version.mjs
-var VERSION = "6.0.0";
+var VERSION = "6.0.1";
 
 // node_modules/openai/internal/detect-platform.mjs
 var isRunningInBrowser = () => {
@@ -129998,7 +129995,7 @@ class ResourceRegistry {
 }
 ResourceRegistry = __legacyDecorateClassTS([
   import_tsyringe9.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe9.injectAll(ResourceDefinitions)),
+  __legacyDecorateParamTS(0, import_tsyringe9.injectAll(ResourceDefinitions, { isOptional: true })),
   __legacyMetadataTS("design:paramtypes", [
     Array
   ])
@@ -130700,7 +130697,7 @@ class ToolRegistry {
 }
 ToolRegistry = __legacyDecorateClassTS([
   import_tsyringe12.injectable(),
-  __legacyDecorateParamTS(0, import_tsyringe12.injectAll(ToolDefinitions)),
+  __legacyDecorateParamTS(0, import_tsyringe12.injectAll(ToolDefinitions, { isOptional: true })),
   __legacyMetadataTS("design:paramtypes", [
     Array
   ])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-ts-template",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "mcpName": "io.github.cyanheads/mcp-ts-template",
   "description": "The definitive, production-grade template for building powerful and scalable Model Context Protocol (MCP) servers with TypeScript, featuring built-in observability (OpenTelemetry), declarative tooling, robust error handling, and a modular, DI-driven architecture.",
   "main": "dist/index.js",
@@ -31,30 +31,27 @@
   "scripts": {
     "build": "bun build ./src/index.ts --outdir ./dist --target node",
     "build:worker": "bun build ./src/worker.ts --outdir ./dist --target bun --no-external",
-    "deploy:dev": "bunx wrangler dev",
-    "deploy:prod": "bunx wrangler deploy",
+    "deploy:dev": "MCP_TRANSPORT_TYPE=http bunx wrangler dev",
+    "deploy:prod": "MCP_TRANSPORT_TYPE=http bunx wrangler deploy",
     "start": "bun ./dist/index.js",
-    "start:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
-    "start:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
-    "start:agent": "MCP_LOG_LEVEL=debug bun ./dist/agent/cli/boot.js",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js",
     "dev": "bun --watch src/index.ts",
     "dev:stdio": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
     "dev:http": "MCP_LOG_LEVEL=debug MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
-    "dev:agent": "MCP_LOG_LEVEL=debug bun --watch src/agent/cli/boot.ts",
     "devdocs": "bun run scripts/devdocs.ts",
     "devcheck": "bun run scripts/devcheck.ts",
     "rebuild": "bun run scripts/clean.ts && bun run build",
-    "docs:generate": "typedoc",
+    "docs:generate": "bunx typedoc",
     "depcheck": "bunx depcheck",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "typecheck": "tsc --noEmit",
+    "lint": "bunx eslint .",
+    "lint:fix": "bunx eslint . --fix",
+    "typecheck": "bunx tsc --noEmit",
     "tree": "bun run scripts/tree.ts",
     "fetch-spec": "bun run scripts/fetch-openapi-spec.ts",
-    "format": "bun run prettier --write \"**/*.{ts,js,json,md,html,css}\"",
-    "prepare": "[ -d .husky ] && husky || true",
+    "format": "bunx prettier --write \"**/*.{ts,js,json,md,html,css}\"",
+    "prepare": "bunx husky",
     "inspector": "bunx mcp-inspector --config mcp.json --server mcp-ts-template",
-    "db:duckdb-example": "MCP_LOG_LEVEL=debug tsc && node dist/storage/duckdbExample.js",
     "test": "bun test --config vitest.config.ts",
     "test:coverage": "bun test --coverage",
     "audit": "bun audit",
@@ -83,22 +80,19 @@
     "jose": "^6.1.0",
     "js-yaml": "^4.1.0",
     "node-cron": "^4.2.1",
-    "openai": "^6.0.0",
+    "openai": "^6.0.1",
     "papaparse": "^5.5.3",
     "partial-json": "^0.1.7",
     "pdf-lib": "^1.17.1",
     "pino": "^9.12.0",
+    "pino-pretty": "^13.1.1",
     "reflect-metadata": "^0.2.2",
     "repomix": "^1.6.0",
     "sanitize-html": "^2.17.0",
     "tslib": "^2.8.1",
     "tsyringe": "^4.10.0",
     "validator": "13.15.15",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250927.0",
-    "@eslint/js": "^9.36.0",
+    "zod": "^3.23.8",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/auto-instrumentations-node": "^0.64.6",
     "@opentelemetry/exporter-metrics-otlp-http": "^0.205.0",
@@ -108,10 +102,14 @@
     "@opentelemetry/sdk-metrics": "^2.1.0",
     "@opentelemetry/sdk-node": "^0.205.0",
     "@opentelemetry/sdk-trace-node": "^2.1.0",
-    "@opentelemetry/semantic-conventions": "^1.37.0",
+    "@opentelemetry/semantic-conventions": "^1.37.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20251001.0",
+    "@eslint/js": "^9.36.0",
     "@types/bun": "^1.2.23",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.6.0",
+    "@types/node": "^24.6.2",
     "@types/node-cron": "^3.0.11",
     "@types/papaparse": "^5.3.16",
     "@types/sanitize-html": "^2.16.0",
@@ -127,12 +125,11 @@
     "globals": "^16.4.0",
     "husky": "^9.1.7",
     "msw": "^2.11.3",
-    "pino-pretty": "^13.1.1",
     "prettier": "^3.6.2",
     "typedoc": "^0.28.13",
-    "typescript": "^5.9.3",
+    "typescript": "^5.9.2",
     "typescript-eslint": "8.45.0",
-    "vite": "^7.1.7",
+    "vite": "^7.1.8",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4"
   },