mcp-ts-template 3.0.1 → 3.0.3

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-3.0.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--11--25-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-11-25/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.27.1-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) 
+[![Version](https://img.shields.io/badge/Version-3.0.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--11--25-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-11-25/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.27.1-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.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-86.30%25-brightgreen.svg?style=flat-square)](./coverage/index.html)
 
@@ -15,6 +15,8 @@
 
 ---
 
+> **Try it live** — A public demo instance is running at `https://mcp-ts-template.caseyjhand.com/mcp`. Connect any MCP client to test the template's tools and resources without installing anything.
+
 ## Features
 
 - Define tools and resources in single, self-contained files. The framework handles registration.
@@ -120,6 +122,19 @@ Add the following to your MCP client configuration file.
 }
 ```
 
+Or connect to the public demo server over HTTP — no installation required:
+
+```json
+{
+  "mcpServers": {
+    "mcp-ts-template": {
+      "type": "streamable-http",
+      "url": "https://mcp-ts-template.caseyjhand.com/mcp"
+    }
+  }
+}
+```
+
 ### Prerequisites
 
 - [Bun v1.2.0](https://bun.sh/) or higher.

package/dist/index.js

@@ -144586,7 +144586,7 @@ config(en_default());
 // package.json
 var package_default = {
   name: "mcp-ts-template",
-  version: "3.0.1",
+  version: "3.0.2",
   mcpName: "io.github.cyanheads/mcp-ts-template",
   description: "TypeScript template for MCP servers with declarative tools/resources, pluggable auth, multi-backend storage, OpenTelemetry observability, and Cloudflare Workers support.",
   main: "dist/index.js",
@@ -169300,6 +169300,7 @@ var Pe = g.object({ method: g.literal("ui/notifications/host-context-changed"),
 var M6 = g.object({ method: g.literal("ui/update-model-context"), params: g.object({ content: g.array(ContentBlockSchema).optional().describe("Context content blocks (text, image, etc.)."), structuredContent: g.record(g.string(), g.unknown().describe("Structured content for machine-readable context data.")).optional().describe("Structured content for machine-readable context data.") }) });
 var R6 = g.object({ method: g.literal("ui/initialize"), params: g.object({ appInfo: ImplementationSchema.describe("App identification (name and version)."), appCapabilities: XI.describe("Features and capabilities this app provides."), protocolVersion: g.string().describe("Protocol version this app supports.") }) });
 var je = g.object({ protocolVersion: g.string().describe('Negotiated protocol version string (e.g., "2025-11-21").'), hostInfo: ImplementationSchema.describe("Host application identification and version."), hostCapabilities: VI.describe("Features and capabilities provided by the host."), hostContext: Se.describe("Rich context about the host environment.") }).passthrough();
+var Je = "ui/resourceUri";
 var AI = "text/html;profile=mcp-app";
 
 class h6 extends Protocol {
@@ -171909,7 +171910,7 @@ class TaskManager {
 // src/mcp-server/tools/definitions/template-async-countdown.task-tool.ts
 var TOOL_NAME = "template_async_countdown";
 var TOOL_TITLE = "Async Countdown (Task Demo)";
-var TOOL_DESCRIPTION = "Demonstrates the MCP Tasks API with a countdown timer. The tool returns immediately with a task handle. Poll the task status to track progress, then retrieve the final result when complete.";
+var TOOL_DESCRIPTION = "Demonstrates the MCP Tasks API with a countdown timer. When the client supports tasks, returns immediately with a task handle for polling. Otherwise, runs synchronously and returns the result directly.";
 var InputSchema = exports_external.object({
   seconds: exports_external.number().int().min(1).max(60).describe("Number of seconds to count down (1-60)"),
   message: exports_external.string().optional().describe("Optional message to include in the final result"),
@@ -172016,7 +172017,7 @@ var asyncCountdownTaskTool = {
     openWorldHint: false
   },
   execution: {
-    taskSupport: "required"
+    taskSupport: "optional"
   },
   taskHandlers: {
     createTask: async (args, extra) => {
@@ -172323,7 +172324,8 @@ var dataExplorerAppTool = {
   logic: withToolAuth(["tool:data-explorer:read"], dataExplorerLogic),
   responseFormatter: responseFormatter3,
   _meta: {
-    ui: { resourceUri: UI_RESOURCE_URI }
+    ui: { resourceUri: UI_RESOURCE_URI },
+    [Je]: UI_RESOURCE_URI
   }
 };
 
@@ -178657,32 +178659,29 @@ function createHttpApp(serverFactory, parentContext) {
     const handleRpc = async () => {
       const server2 = await serverFactory();
       await server2.connect(transport);
-      try {
-        const response = await transport.handleRequest(c);
-        if (response && config2.mcpSessionMode === "stateful") {
-          response.headers.set("Mcp-Session-Id", sessionId);
-          logger.debug("Added Mcp-Session-Id header to response", {
-            ...transportContext,
-            sessionId
-          });
-        }
-        if (response) {
-          return response;
-        }
-        return c.body(null, 204);
-      } finally {
-        await server2.close().catch((closeErr) => {
-          logger.debug("Failed to close per-request server", {
-            ...transportContext,
-            sessionId,
-            error: closeErr instanceof Error ? closeErr.message : String(closeErr)
-          });
+      const response = await transport.handleRequest(c);
+      if (response && config2.mcpSessionMode === "stateful") {
+        response.headers.set("Mcp-Session-Id", sessionId);
+        logger.debug("Added Mcp-Session-Id header to response", {
+          ...transportContext,
+          sessionId
         });
       }
+      if (response) {
+        return response;
+      }
+      return c.body(null, 204);
     };
     try {
       return await handleRpc();
     } catch (err) {
+      await transport.close?.().catch((closeErr) => {
+        logger.debug("Failed to close transport after error", {
+          ...transportContext,
+          sessionId,
+          error: closeErr instanceof Error ? closeErr.message : String(closeErr)
+        });
+      });
       throw err instanceof Error ? err : new Error(String(err));
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-ts-template",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "mcpName": "io.github.cyanheads/mcp-ts-template",
   "description": "TypeScript template for MCP servers with declarative tools/resources, pluggable auth, multi-backend storage, OpenTelemetry observability, and Cloudflare Workers support.",
   "main": "dist/index.js",