chore: update MCP SDK compatibility range to >=1.11

Updates minimum MCP SDK version requirement from 1.3 to 1.11 across the project.
This ensures compatibility with newer SDK features while maintaining backward compatibility
with versions 1.11 and above.

Changes:
- Update GitHub workflow to test versions >=1.11
- Update devDependency to @modelcontextprotocol/sdk@1.11
- Update peerDependencies requirement to >=1.11
- Update compatibility module for SDK version 1.11+ support

Author: naji247

.github/workflows/mcp-compatibility.yml

@@ -32,15 +32,15 @@ jobs:
         with:
           version: 9
 
-      - name: Fetch all available MCP SDK versions (≥1.3)
+      - name: Fetch all available MCP SDK versions (≥1.11)
         id: get-versions
         run: |
-          # Get all versions >= 1.3 and filter to get latest patch for each minor version
+          # Get all versions >= 1.11 and filter to get latest patch for each minor version
           VERSIONS=$(pnpm view @modelcontextprotocol/sdk versions --json | jq -c '
             map(select(test("^[0-9]+\\.[0-9]+\\.[0-9]+$"))) |
             map(select(
               (split(".")[0] | tonumber > 1) or
-              ((split(".")[0] | tonumber == 1) and (split(".")[1] | tonumber >= 3))
+              ((split(".")[0] | tonumber == 1) and (split(".")[1] | tonumber >= 11))
             )) |
             group_by(split(".")[0:2] | join(".")) |
             map(max_by(split(".") | map(tonumber))) |

package.json

@@ -54,7 +54,7 @@
   "packageManager": "pnpm@10.11.0",
   "devDependencies": {
     "@changesets/cli": "^2.29.4",
-    "@modelcontextprotocol/sdk": "1.17.1",
+    "@modelcontextprotocol/sdk": "1.11",
     "@types/node": "^22.15.21",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",
@@ -69,7 +69,7 @@
     "vitest": "^3.1.4"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": ">=1.3.1"
+    "@modelcontextprotocol/sdk": ">=1.11"
   },
   "dependencies": {
     "@opentelemetry/otlp-transformer": "^0.203.0",

pnpm-lock.yaml

@@ -1,10 +1,23 @@
 import { HighLevelMCPServerLike, MCPServerLike } from "../types.js";
 import { writeToLog } from "./logging.js";
 
+/**
+ * MCPCat Compatibility Module
+ *
+ * This module ensures compatibility with Model Context Protocol TypeScript SDK.
+ * MCPCat only supports MCP SDK version 1.11 and above.
+ *
+ * Version 1.11+ is required because it introduced stable APIs for:
+ * - Tool registration and handling
+ * - Request handler access patterns
+ * - Client version detection
+ * - Server info structure
+ */
+
 // Function to log compatibility information
 export function logCompatibilityWarning(): void {
   writeToLog(
-    "MCPCat SDK Compatibility: This version supports MCP SDK versions v1.0 - v1.12",
+    "MCPCat SDK Compatibility: This version only supports Model Context Protocol TypeScript SDK v1.11 and above. Please upgrade if using an older version.",
   );
 }
 
@@ -30,7 +43,7 @@ export function isCompatibleServerType(
   if (!server || typeof server !== "object") {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server must be an object.",
+      "MCPCat SDK compatibility error: Server must be an object. Ensure you're using MCP SDK v1.11 or higher.",
     );
   }
 
@@ -42,13 +55,13 @@ export function isCompatibleServerType(
     ) {
       logCompatibilityWarning();
       throw new Error(
-        "MCPCat SDK compatibility error: High-level server must have _registeredTools object.",
+        "MCPCat SDK compatibility error: High-level server must have _registeredTools object. This requires MCP SDK v1.11 or higher.",
       );
     }
     if (typeof server.tool !== "function") {
       logCompatibilityWarning();
       throw new Error(
-        "MCPCat SDK compatibility error: High-level server must have tool() method.",
+        "MCPCat SDK compatibility error: High-level server must have tool() method. This requires MCP SDK v1.11 or higher.",
       );
     }
 
@@ -69,29 +82,29 @@ function validateLowLevelServer(server: any): void {
   if (typeof server.setRequestHandler !== "function") {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server must have a setRequestHandler method.",
+      "MCPCat SDK compatibility error: Server must have a setRequestHandler method. This requires MCP SDK v1.11 or higher.",
     );
   }
 
   if (!server._requestHandlers || !(server._requestHandlers instanceof Map)) {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server._requestHandlers is not accessible.",
+      "MCPCat SDK compatibility error: Server._requestHandlers is not accessible. This requires MCP SDK v1.11 or higher.",
     );
   }
 
   // Validate that _requestHandlers contains functions with compatible signatures
   if (typeof server._requestHandlers.get !== "function") {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server._requestHandlers must be a Map with a get method.",
+      "MCPCat SDK compatibility error: Server._requestHandlers must be a Map with a get method. This requires MCP SDK v1.11 or higher.",
     );
   }
 
   if (typeof server.getClientVersion !== "function") {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server.getClientVersion must be a function.",
+      "MCPCat SDK compatibility error: Server.getClientVersion must be a function. This requires MCP SDK v1.11 or higher.",
     );
   }
 
@@ -102,7 +115,7 @@ function validateLowLevelServer(server: any): void {
   ) {
     logCompatibilityWarning();
     throw new Error(
-      "MCPCat SDK compatibility error: Server._serverInfo is not accessible or missing name.",
+      "MCPCat SDK compatibility error: Server._serverInfo is not accessible or missing name. This requires MCP SDK v1.11 or higher.",
     );
   }
 }