feat: add dynamic tool registration support for high-level MCP servers

  - Add support for TypeScript MCP SDK's high-level server API that uses .tool() method
  for registration
  - Implement dynamic proxying of _registeredTools to inject context parameters and
  tracing at runtime
  - Support both low-level (direct handler) and high-level (wrapper with .server
  property) server architectures
  - Add new tracingV2 module that handles tool registration via proxy interceptors
  - Update compatibility checks to differentiate between server types
  - Ensure backward compatibility with existing low-level server implementations
  - Add RegisteredTool and HighLevelMCPServerLike types for better type safety
  - Update tests to support both server architectures

  This enables MCPCat to work seamlessly with servers using the TypeScript MCP SDK's
  simplified API while maintaining full compatibility with direct protocol
  implementations.

Author: naji247

.github/workflows/mcp-compatibility.yml

@@ -32,13 +32,16 @@ jobs:
         with:
           version: 9
 
-      - name: Fetch all available MCP SDK versions (≥1.0)
+      - name: Fetch all available MCP SDK versions (≥1.3)
         id: get-versions
         run: |
-          # Get all versions >= 1.0 and filter to get latest patch for each minor version
+          # Get all versions >= 1.3 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)) |
+            map(select(
+              (split(".")[0] | tonumber > 1) or
+              ((split(".")[0] | tonumber == 1) and (split(".")[1] | tonumber >= 3))
+            )) |
             group_by(split(".")[0:2] | join(".")) |
             map(max_by(split(".") | map(tonumber))) |
             sort_by(split(".") | map(tonumber))

eslint.config.js

@@ -17,7 +17,10 @@ export default [
     rules: {
       "@typescript-eslint/no-unused-vars": [
         "error",
-        { argsIgnorePattern: "^_" },
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+        },
       ],
       "@typescript-eslint/no-explicit-any": "off",
     },

package.json

@@ -54,7 +54,7 @@
   "packageManager": "pnpm@10.11.0",
   "devDependencies": {
     "@changesets/cli": "^2.29.4",
-    "@modelcontextprotocol/sdk": "1.3.0",
+    "@modelcontextprotocol/sdk": "1.17.1",
     "@types/node": "^22.15.21",
     "@typescript-eslint/eslint-plugin": "^8.32.1",
     "@typescript-eslint/parser": "^8.32.1",
@@ -69,11 +69,12 @@
     "vitest": "^3.1.4"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": ">=1.0.0"
+    "@modelcontextprotocol/sdk": ">=1.3.1"
   },
   "dependencies": {
     "mcpcat-api": "0.1.3",
-    "redact-pii": "3.4.0"
+    "redact-pii": "3.4.0",
+    "zod": "3.25.30"
   },
   "lint-staged": {
     "*.{ts,js}": [