modality-mcp-kit 1.4.4 → 1.5.1

package/dist/FastHonoMcp.js

@@ -23,15 +23,15 @@
  * https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema
  * https://modelcontextprotocol.io/specification/2025-11-25/schema
  */
-import { ModalityFastMCP } from "./util_mcp_tools_converter.js";
-import { createMcpConnectionDemoHandler } from "./util_mcp_connection_demo.js";
-import { JSONRPCManager, getLoggerInstance, } from "modality-kit";
-import { sseNotification, sseError, SSE_HEADERS, createSSEStream, } from "./sse-wrapper.js";
-import { McpSessionManager } from "./McpSessionManager.js";
-import { handleToolCall } from "./handlers/tools-call-handler.js";
+import { JSONRPCManager, getLoggerInstance } from "modality-kit";
+import { ModalityFastMCP } from "./util_mcp_tools_converter";
+import { createMcpConnectionDemoHandler } from "./util_mcp_connection_demo";
+import { sseNotification, sseError, SSE_HEADERS, createSSEStream, } from "./sse-wrapper";
+import { McpSessionManager } from "./McpSessionManager";
+import { handleToolCall } from "./handlers/tools-call-handler";
 const defaultMcpPath = "/mcp";
 const defaultMcpDemoPath = "/";
-const mcpSchemaVersion = "2025-11-25";
+const defaultMcpSchemaVersion = "2025-11-25";
 // Initialize FastMCP instance for internal use (NO SERVER)
 export class FastHonoMcp extends ModalityFastMCP {
     logger;
@@ -130,16 +130,23 @@ export class FastHonoMcp extends ModalityFastMCP {
                     const requestSessionId = c.req.header("mcp-session-id");
                     const sessionId = this.ensureSession(requestSessionId);
                     c.header("mcp-session-id", sessionId);
-                    const bodyText = await c.req.text();
-                    this.logger.info("MCP Middleware Received Body", { bodyText });
+                    const requestData = await c.req.json();
+                    const requestProtocolVersion = requestData?.params?.protocolVersion;
+                    this.logger.info("MCP Middleware Received Body", {
+                        requestData,
+                        sessionId,
+                    });
+                    // Store protocol version in session if provided
+                    if (requestProtocolVersion) {
+                        this.sessions.setProtocolVersion(sessionId, requestProtocolVersion);
+                    }
                     // Handle notifications/initialized
                     try {
-                        const requestData = JSON.parse(bodyText);
                         if (requestData?.method === "notifications/initialized") {
                             Object.entries(SSE_HEADERS).forEach(([key, value]) => {
                                 c.header(key, value);
                             });
-                            return c.text(sseNotification(), 200);
+                            return c.text(sseNotification(), 202);
                         }
                     }
                     catch {
@@ -151,7 +158,7 @@ export class FastHonoMcp extends ModalityFastMCP {
                         ...corsHeaders,
                     };
                     return createSSEStream(async (writer) => {
-                        const result = await createJsonRpcManager(this).validateMessage(bodyText);
+                        const result = await createJsonRpcManager(this, sessionId).validateMessage(requestData);
                         await writer.send(result);
                         await writer.close();
                     }, responseHeaders);
@@ -174,7 +181,7 @@ class HonoJSONRPCManager extends JSONRPCManager {
         return message;
     }
 }
-function createJsonRpcManager(middleware) {
+function createJsonRpcManager(middleware, sessionId) {
     const mcpTools = middleware.getTools();
     const mcpPrompts = middleware.getPrompts();
     const jsonrpc = new HonoJSONRPCManager();
@@ -190,9 +197,12 @@ function createJsonRpcManager(middleware) {
             if (!params.protocolVersion) {
                 throw new Error("Missing required parameter: protocolVersion");
             }
+            // Get protocol version from session or use default
+            const session = middleware.sessions.get(sessionId);
+            const responseProtocolVersion = session?.protocolVersion || defaultMcpSchemaVersion;
             // Return valid InitializeResult
             return {
-                protocolVersion: mcpSchemaVersion,
+                protocolVersion: responseProtocolVersion,
                 capabilities: {
                     tools: { listChanged: true },
                     ...(mcpPrompts.length > 0 && { prompts: { listChanged: true } }),

package/dist/McpSessionManager.js

@@ -31,6 +31,15 @@ export class McpSessionManager {
             session.lastActivity = new Date();
         }
     }
+    /**
+     * Set protocol version for a session
+     */
+    setProtocolVersion(sessionId, protocolVersion) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.protocolVersion = protocolVersion;
+        }
+    }
     /**
      * Remove a session
      */

package/dist/types/FastHonoMcp.d.ts

@@ -24,9 +24,9 @@
  * https://modelcontextprotocol.io/specification/2025-11-25/schema
  */
 import type { MiddlewareHandler, Hono } from "hono";
-import { ModalityFastMCP } from "./util_mcp_tools_converter.js";
 import { getLoggerInstance } from "modality-kit";
-import { McpSessionManager } from "./McpSessionManager.js";
+import { ModalityFastMCP } from "./util_mcp_tools_converter";
+import { McpSessionManager } from "./McpSessionManager";
 export interface FastHonoMcpConfig extends Record<string, unknown> {
     name: string;
     version: string;

package/dist/types/McpSessionManager.d.ts

@@ -5,6 +5,7 @@ export interface McpSession {
     id: string;
     createdAt: Date;
     lastActivity: Date;
+    protocolVersion?: string;
 }
 export declare class McpSessionManager {
     private sessions;
@@ -20,6 +21,10 @@ export declare class McpSessionManager {
      * Update last activity timestamp
      */
     touch(sessionId: string): void;
+    /**
+     * Set protocol version for a session
+     */
+    setProtocolVersion(sessionId: string, protocolVersion: string): void;
     /**
      * Remove a session
      */

package/dist/util_mcp_proxy.js

@@ -210,6 +210,25 @@ export const mcpProxyHandler = (MCP_SERVERS) => async (c) => {
             availableServers: Object.keys(MCP_SERVERS),
         }, 400);
     }
+    // Handle /_cache sub-routes (matched via app.use prefix routing)
+    const cachePathMatch = c.req.path.match(/\/_cache(?:\/(.+))?$/);
+    if (cachePathMatch) {
+        const cache = serverCaches.get(mcpName);
+        if (!cache) {
+            return c.json({ error: "No cache for this MCP server", keys: [] });
+        }
+        const cacheKey = cachePathMatch[1]
+            ? decodeURIComponent(cachePathMatch[1])
+            : undefined;
+        if (cacheKey) {
+            const entry = cache.get(cacheKey, true);
+            if (!entry) {
+                return c.json({ error: "Cache key not found", cacheKey }, 404);
+            }
+            return c.json({ cacheKey, value: entry });
+        }
+        return c.json({ keys: cache.keys() });
+    }
     // Handle CORS preflight
     if (c.req.method === "OPTIONS") {
         return new Response(null, {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.4.4",
+  "version": "1.5.1",
   "name": "modality-mcp-kit",
   "repository": {
     "type": "git",
@@ -28,7 +28,7 @@
   "dependencies": {
     "@valibot/to-json-schema": "^1.5.0",
     "effect": "^3.19.14",
-    "modality-kit": "^0.14.17",
+    "modality-kit": "^0.16.0",
     "sury": "^11.0.0-alpha.4",
     "xsschema": "0.3.5",
     "zod-to-json-schema": "^3.25.1"