merge commit

Author: KKonstantinov

package-lock.json

@@ -32,17 +32,19 @@
         "client": "tsx scripts/cli.ts client"
     },
     "dependencies": {
-        "@modelcontextprotocol/sdk-server": "workspace:^",
+        "@hono/node-server": "catalog:runtimeServerOnly",
+        "hono": "catalog:runtimeServerOnly",
         "@modelcontextprotocol/sdk-examples-shared": "workspace:^",
-        "zod": "catalog:runtimeShared",
+        "@modelcontextprotocol/sdk-server": "workspace:^",
+        "cors": "catalog:runtimeServerOnly",
         "express": "catalog:runtimeServerOnly",
-        "cors": "catalog:runtimeServerOnly"
+        "zod": "catalog:runtimeShared"
     },
     "devDependencies": {
-        "@modelcontextprotocol/tsconfig": "workspace:^",
         "@modelcontextprotocol/eslint-config": "workspace:^",
+        "@modelcontextprotocol/tsconfig": "workspace:^",
         "@modelcontextprotocol/vitest-config": "workspace:^",
-        "@types/express": "catalog:devTools",
-        "@types/cors": "catalog:devTools"
+        "@types/cors": "catalog:devTools",
+        "@types/express": "catalog:devTools"
     }
 }

packages/examples/server/package.json

@@ -0,0 +1,73 @@
+/**
+ * Example MCP server using Hono with WebStandardStreamableHTTPServerTransport
+ *
+ * This example demonstrates using the Web Standard transport directly with Hono,
+ * which works on any runtime: Node.js, Cloudflare Workers, Deno, Bun, etc.
+ *
+ * Run with: npx tsx src/examples/server/honoWebStandardStreamableHttp.ts
+ */
+
+import { serve } from '@hono/node-server';
+import type { CallToolResult } from '@modelcontextprotocol/sdk-server';
+import { McpServer, WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk-server';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import * as z from 'zod/v4';
+
+// Create the MCP server
+const server = new McpServer({
+    name: 'hono-webstandard-mcp-server',
+    version: '1.0.0'
+});
+
+// Register a simple greeting tool
+server.registerTool(
+    'greet',
+    {
+        title: 'Greeting Tool',
+        description: 'A simple greeting tool',
+        inputSchema: { name: z.string().describe('Name to greet') }
+    },
+    async ({ name }): Promise<CallToolResult> => {
+        return {
+            content: [{ type: 'text', text: `Hello, ${name}! (from Hono + WebStandard transport)` }]
+        };
+    }
+);
+
+// Create a stateless transport (no options = no session management)
+const transport = new WebStandardStreamableHTTPServerTransport();
+
+// Create the Hono app
+const app = new Hono();
+
+// Enable CORS for all origins
+app.use(
+    '*',
+    cors({
+        origin: '*',
+        allowMethods: ['GET', 'POST', 'DELETE', 'OPTIONS'],
+        allowHeaders: ['Content-Type', 'mcp-session-id', 'Last-Event-ID', 'mcp-protocol-version'],
+        exposeHeaders: ['mcp-session-id', 'mcp-protocol-version']
+    })
+);
+
+// Health check endpoint
+app.get('/health', c => c.json({ status: 'ok' }));
+
+// MCP endpoint
+app.all('/mcp', c => transport.handleRequest(c.req.raw));
+
+// Start the server
+const PORT = process.env.MCP_PORT ? parseInt(process.env.MCP_PORT, 10) : 3000;
+
+server.connect(transport).then(() => {
+    console.log(`Starting Hono MCP server on port ${PORT}`);
+    console.log(`Health check: http://localhost:${PORT}/health`);
+    console.log(`MCP endpoint: http://localhost:${PORT}/mcp`);
+
+    serve({
+        fetch: app.fetch,
+        port: PORT
+    });
+});

packages/examples/server/src/honoWebStandardStreamableHttp.ts

@@ -47,6 +47,8 @@
     "dependencies": {
         "content-type": "catalog:runtimeServerOnly",
         "cors": "catalog:runtimeServerOnly",
+        "@hono/node-server": "catalog:runtimeServerOnly",
+        "hono": "catalog:runtimeServerOnly",
         "express": "catalog:runtimeServerOnly",
         "express-rate-limit": "catalog:runtimeServerOnly",
         "raw-body": "catalog:runtimeServerOnly",

packages/server/package.json

@@ -6,6 +6,7 @@ export * from './server/server.js';
 export * from './server/sse.js';
 export * from './server/stdio.js';
 export * from './server/streamableHttp.js';
+export * from './server/webStandardStreamableHttp.js';
 
 // auth exports
 export * from './server/auth/index.js';

packages/server/src/index.ts

@@ -1,6 +1,6 @@
 import type { JSONRPCMessage } from '@modelcontextprotocol/sdk-core';
 
-import type { EventStore } from './streamableHttp.js';
+import type { EventStore } from './webStandardStreamableHttp.js';
 
 /**
  * Simple in-memory implementation of the EventStore interface for resumability