mcp-use 2.0.0-beta.13 → 2.0.0-beta.14

package/dist/index.d.ts

@@ -45,8 +45,8 @@ export type { InspectorOptions, ServerConfig, CorsOptions } from "./config.js";
 export type { ServerBranding } from "./branding.js";
 /** Official MCP icon shape used by {@link ServerConfig.icons}. */
 export type { Icon } from "@modelcontextprotocol/server";
-export type { MiddlewareContext, McpCompleteEventListenerFn, McpEventListenerFn, McpMiddlewareFn, McpMiddlewareFnFor, McpMiddlewarePatternMap, PromptsGetMiddlewareContext, ResourcesReadMiddlewareContext, ToolsCallMiddlewareContext, } from "./middleware/mcp-middleware.js";
-export { composeMiddleware, matchesPattern, } from "./middleware/mcp-middleware.js";
+export type { MiddlewareContext, McpMiddlewareContext, McpCompleteEventListenerFn, McpEventListenerFnFor, McpEventPattern, McpEventPatternBody, McpEventListenerFn, McpExactMiddlewareFn, McpMiddlewareFn, McpMiddlewareFnFor, McpMiddlewareMethod, McpMiddlewareMethodsForPattern, McpMiddlewareNext, McpMiddlewareOperationMap, McpMiddlewareParams, McpMiddlewarePattern, McpMiddlewarePatternBody, McpMiddlewarePatternMap, McpMiddlewareResult, PromptsGetMiddlewareContext, PromptsListMiddlewareContext, ReadonlyMiddlewareContext, ResourcesReadMiddlewareContext, ResourcesListMiddlewareContext, ToolsCallMiddlewareContext, ToolsListMiddlewareContext, } from "./middleware/mcp-middleware.js";
+export { composeMiddleware, createMcpEventListenerEntry, createMcpMiddlewareEntry, matchesPattern, } from "./middleware/mcp-middleware.js";
 export type { NodeRequestHandler } from "./node-bridge.js";
 export type { FromOpenAPIOptions, OpenAPIAuth, OpenAPIDocument, OpenAPIExcludeRule, } from "./openapi/index.js";
 export type { Elicit, ElicitationResult, OAuthAuth, RequestClientContext, RequestContext, } from "./context.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -51,7 +51,7 @@ import {
   localhostAllowedOrigins,
   McpServer as SdkMcpServer,
   ResourceTemplate,
-  isInputRequiredResult
+  isInputRequiredResult as isInputRequiredResult2
 } from "@modelcontextprotocol/server";
 
 // src/branding.ts
@@ -563,6 +563,72 @@ function isGlobalCorsEnabled(cors) {
 }
 
 // src/middleware/mcp-middleware.ts
+import {
+  CallToolResultSchema,
+  GetPromptResultSchema,
+  ListPromptsResultSchema,
+  ListResourcesResultSchema,
+  ListToolsResultSchema,
+  ReadResourceResultSchema
+} from "@modelcontextprotocol/core";
+import { isInputRequiredResult } from "@modelcontextprotocol/server";
+var MCP_MIDDLEWARE_METHODS = [
+  "tools/call",
+  "tools/list",
+  "resources/read",
+  "resources/list",
+  "prompts/get",
+  "prompts/list"
+];
+function withMcpMiddlewareParams(request, params) {
+  if (typeof request !== "object" || request === null || Array.isArray(request)) {
+    throw new TypeError(
+      "[mcp-use] MCP middleware received an invalid downstream request"
+    );
+  }
+  return { ...request, params };
+}
+function createMcpMiddlewareEntry(pattern, handler) {
+  const normalizedPattern = normalizeMcpMiddlewarePattern(pattern);
+  const invoke = handler;
+  if (normalizedPattern !== "*" && !isMcpMiddlewareMethod(normalizedPattern)) {
+    throw new TypeError(
+      `Unsupported MCP middleware pattern "${pattern}". Use an exact MCP method or "mcp:*".`
+    );
+  }
+  if (normalizedPattern === "*") {
+    return {
+      pattern: normalizedPattern,
+      handler: async (ctx, next) => {
+        let downstreamCalled = false;
+        let downstreamResult;
+        await invoke(ctx, async () => {
+          downstreamResult = await next();
+          downstreamCalled = true;
+        });
+        if (!downstreamCalled) {
+          throw new Error(
+            `Wildcard MCP middleware "${normalizedPattern}" must call next()`
+          );
+        }
+        return downstreamResult;
+      }
+    };
+  }
+  return {
+    pattern: normalizedPattern,
+    handler: (ctx, next) => invoke(ctx, next)
+  };
+}
+function createMcpEventListenerEntry(pattern, handler) {
+  const { pattern: normalizedPattern, phase } = parseMcpPattern(pattern);
+  const invoke = handler;
+  return {
+    pattern: normalizedPattern,
+    phase,
+    handler: (ctx, result) => invoke(ctx, result)
+  };
+}
 function matchesPattern(pattern, method) {
   if (pattern === "*") return true;
   if (pattern.endsWith("/*")) {
@@ -571,8 +637,13 @@ function matchesPattern(pattern, method) {
   }
   return pattern === method;
 }
+function isMcpMiddlewareMethod(value) {
+  return MCP_MIDDLEWARE_METHODS.some((method) => method === value);
+}
 function composeMiddleware(entries, method, innerFn) {
-  const matching = entries.filter((e) => matchesPattern(e.pattern, method));
+  const matching = entries.filter(
+    (entry) => matchesPattern(entry.pattern, method)
+  );
   if (matching.length === 0) {
     return (_ctx) => innerFn();
   }
@@ -596,17 +667,69 @@ function freezeMiddlewareContext(ctx) {
   return Object.freeze({
     method: ctx.method,
     params: Object.freeze({ ...ctx.params }),
+    ...ctx.session !== void 0 && {
+      session: Object.freeze({ ...ctx.session })
+    },
     ...ctx.auth !== void 0 && { auth: ctx.auth },
-    state: ctx.state
+    state: new Map(ctx.state)
   });
 }
 async function runMcpOperation(middlewares, events, method, ctx, innerFn) {
   dispatchMcpEvents(events, method, "before", ctx);
   const chained = composeMiddleware(middlewares, method, innerFn);
   const result = await chained(ctx);
+  assertValidMiddlewareResult(method, result);
   dispatchMcpEvents(events, method, "complete", ctx, result);
   return result;
 }
+function assertValidMiddlewareResult(method, result) {
+  if ((method === "tools/call" || method === "resources/read" || method === "prompts/get") && isInputRequiredResult(result)) {
+    return;
+  }
+  const validation = (() => {
+    switch (method) {
+      case "tools/call":
+        assertArrayProperty(method, result, "content");
+        return CallToolResultSchema.safeParse(result);
+      case "tools/list":
+        assertArrayResult(method, result);
+        return ListToolsResultSchema.safeParse({ tools: result });
+      case "resources/read":
+        assertArrayProperty(method, result, "contents");
+        return ReadResourceResultSchema.safeParse(result);
+      case "resources/list":
+        assertArrayResult(method, result);
+        return ListResourcesResultSchema.safeParse({ resources: result });
+      case "prompts/get":
+        assertArrayProperty(method, result, "messages");
+        return GetPromptResultSchema.safeParse(result);
+      case "prompts/list":
+        assertArrayResult(method, result);
+        return ListPromptsResultSchema.safeParse({ prompts: result });
+      default:
+        throw new TypeError(`Unsupported MCP middleware method "${method}"`);
+    }
+  })();
+  if (!validation.success) {
+    throw new TypeError(
+      `[mcp-use] ${method} middleware returned an invalid result: ${validation.error.message}`
+    );
+  }
+}
+function assertArrayResult(method, result) {
+  if (!Array.isArray(result)) {
+    throw new TypeError(
+      `[mcp-use] ${method} middleware returned an invalid result: expected an array`
+    );
+  }
+}
+function assertArrayProperty(method, result, property) {
+  if (typeof result !== "object" || result === null || !Array.isArray(result[property])) {
+    throw new TypeError(
+      `[mcp-use] ${method} middleware returned an invalid result: expected a ${property} array`
+    );
+  }
+}
 function dispatchMcpEvents(events, method, phase, ctx, result) {
   const frozen = freezeMiddlewareContext(ctx);
   for (const entry of events) {
@@ -614,11 +737,7 @@ function dispatchMcpEvents(events, method, phase, ctx, result) {
       continue;
     }
     try {
-      if (phase === "before") {
-        entry.handler(frozen);
-      } else {
-        entry.handler(frozen, result);
-      }
+      entry.handler(frozen, result);
     } catch (error) {
       console.error(
         `[mcp-use] MCP event listener for "${entry.pattern}" (${phase}) threw:`,
@@ -1412,6 +1531,21 @@ function viewResourceConfig(_viewName, _entry, authorFacts, options) {
 }
 
 // src/server.ts
+function omitRootSchemaDialect(schema) {
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema) || !("$schema" in schema)) {
+    return schema;
+  }
+  const emittedSchema = { ...schema };
+  delete emittedSchema["$schema"];
+  return emittedSchema;
+}
+function omitToolSchemaDialects(tools) {
+  return tools.map((tool) => ({
+    ...tool,
+    inputSchema: omitRootSchemaDialect(tool.inputSchema),
+    ...tool.outputSchema === void 0 ? {} : { outputSchema: omitRootSchemaDialect(tool.outputSchema) }
+  }));
+}
 var MCPServer = class _MCPServer {
   #config;
   #branding;
@@ -1692,7 +1826,9 @@ var MCPServer = class _MCPServer {
    * Register MCP operation middleware that intercepts JSON-RPC dispatch.
    *
    * Patterns use an `mcp:` prefix (for example `mcp:tools/call`, `mcp:*`).
-   * Middleware runs in registration order; call `next()` to continue the chain.
+   * Exact methods may transform their typed result. The global `mcp:*` pattern
+   * is pass-through middleware. Middleware runs in registration order; call
+   * `next()` to continue the chain.
    *
    * @example
    * ```ts
@@ -1704,10 +1840,7 @@ var MCPServer = class _MCPServer {
    */
   use(pattern, handler) {
     this.#assertNotStarted("middleware", pattern);
-    this.#mcpMiddlewares.push({
-      pattern: normalizeMcpMiddlewarePattern(pattern),
-      handler
-    });
+    this.#mcpMiddlewares.push(createMcpMiddlewareEntry(pattern, handler));
     return this;
   }
   /**
@@ -1727,12 +1860,7 @@ var MCPServer = class _MCPServer {
    */
   on(pattern, handler) {
     this.#assertNotStarted("event listener", pattern);
-    const { pattern: stripped, phase } = parseMcpPattern(pattern);
-    this.#mcpEventListeners.push({
-      pattern: stripped,
-      phase,
-      handler
-    });
+    this.#mcpEventListeners.push(createMcpEventListenerEntry(pattern, handler));
     return this;
   }
   /**
@@ -2287,6 +2415,9 @@ var MCPServer = class _MCPServer {
     return {
       method,
       params,
+      ...ctx.sessionId !== void 0 && {
+        session: { sessionId: ctx.sessionId }
+      },
       ...ctx.http?.authInfo !== void 0 && { auth: ctx.http.authInfo },
       state: /* @__PURE__ */ new Map()
     };
@@ -2312,7 +2443,7 @@ var MCPServer = class _MCPServer {
     if (handlers === void 0) {
       return;
     }
-    const wrapListMethod = (method, resultKey) => {
+    const wrapListMethod = (method, resultKey, transform) => {
       const original = handlers.get(method);
       if (original === void 0) {
         return;
@@ -2321,27 +2452,50 @@ var MCPServer = class _MCPServer {
         return;
       }
       const wrapped = async (request, extra) => {
-        const authInfo = extra?.http?.authInfo;
-        const mwCtx = {
+        const serverContext = extra;
+        const params = request.params ?? {};
+        const mwCtx = this.#createMiddlewareContext(
           method,
-          params: {},
-          ...authInfo !== void 0 && { auth: authInfo },
-          state: /* @__PURE__ */ new Map()
-        };
+          params,
+          serverContext
+        );
+        let originalEnvelope;
         const innerFn = async () => {
-          const result = await original(request, extra);
-          return result[resultKey] ?? result;
+          const downstreamRequest = withMcpMiddlewareParams(
+            request,
+            mwCtx.params
+          );
+          const result = await original(downstreamRequest, extra);
+          if (typeof result !== "object" || result === null) {
+            throw new TypeError(
+              `[mcp-use] ${method} handler returned a non-object result`
+            );
+          }
+          originalEnvelope = result;
+          const items = originalEnvelope[resultKey];
+          if (!Array.isArray(items)) {
+            throw new TypeError(
+              `[mcp-use] ${method} handler result is missing a ${resultKey} array`
+            );
+          }
+          return items;
         };
         const filtered = await this.#runMcpHook(method, mwCtx, innerFn);
-        if (Array.isArray(filtered)) {
-          return { [resultKey]: filtered };
+        if (!Array.isArray(filtered)) {
+          throw new TypeError(
+            `[mcp-use] ${method} middleware must return a ${resultKey} array`
+          );
         }
-        return filtered;
+        const emitted = transform?.(filtered) ?? filtered;
+        return {
+          ...originalEnvelope,
+          [resultKey]: emitted
+        };
       };
       wrapped.__mcpListWrapped = true;
       handlers.set(method, wrapped);
     };
-    wrapListMethod("tools/list", "tools");
+    wrapListMethod("tools/list", "tools", omitToolSchemaDialects);
     wrapListMethod("resources/list", "resources");
     wrapListMethod("prompts/list", "prompts");
   }
@@ -2370,7 +2524,11 @@ var MCPServer = class _MCPServer {
     const invokeTool = async (args, ctx) => {
       const mwCtx = this.#createMiddlewareContext(
         "tools/call",
-        { name: definition.name, arguments: args },
+        {
+          name: definition.name,
+          arguments: args,
+          ...ctx.mcpReq._meta !== void 0 && { _meta: ctx.mcpReq._meta }
+        },
         ctx
       );
       const innerFn = async () => {
@@ -2379,7 +2537,7 @@ var MCPServer = class _MCPServer {
           effectiveArgs,
           this.#toRequestContext(ctx)
         );
-        if (isInputRequiredResult(result) || wireResultMeta === void 0 || result.isError === true) {
+        if (isInputRequiredResult2(result) || wireResultMeta === void 0 || result.isError === true) {
           return result;
         }
         return {
@@ -2466,7 +2624,10 @@ var MCPServer = class _MCPServer {
       async (uri, ctx) => {
         const mwCtx = this.#createMiddlewareContext(
           "resources/read",
-          { uri: uri.href },
+          {
+            uri: uri.href,
+            ...ctx.mcpReq._meta !== void 0 && { _meta: ctx.mcpReq._meta }
+          },
           ctx
         );
         const innerFn = async () => callback(uri, this.#toRequestContext(ctx));
@@ -2504,7 +2665,10 @@ var MCPServer = class _MCPServer {
       async (uri, variables, ctx) => {
         const mwCtx = this.#createMiddlewareContext(
           "resources/read",
-          { uri: uri.href },
+          {
+            uri: uri.href,
+            ...ctx.mcpReq._meta !== void 0 && { _meta: ctx.mcpReq._meta }
+          },
           ctx
         );
         const innerFn = async () => callback(
@@ -2548,7 +2712,11 @@ var MCPServer = class _MCPServer {
     const invokePrompt = async (args, ctx) => {
       const mwCtx = this.#createMiddlewareContext(
         "prompts/get",
-        { name: definition.name, arguments: args },
+        {
+          name: definition.name,
+          arguments: args,
+          ...ctx.mcpReq._meta !== void 0 && { _meta: ctx.mcpReq._meta }
+        },
         ctx
       );
       const innerFn = async () => {
@@ -2586,7 +2754,7 @@ import {
   createRequestStateCodec,
   inputRequired as inputRequired2,
   inputResponse as inputResponse2,
-  isInputRequiredResult as isInputRequiredResult2
+  isInputRequiredResult as isInputRequiredResult3
 } from "@modelcontextprotocol/server";
 export {
   MCPServer,
@@ -2594,13 +2762,15 @@ export {
   completable,
   composeFetch,
   composeMiddleware,
+  createMcpEventListenerEntry,
+  createMcpMiddlewareEntry,
   createMcpMount,
   createRequestStateCodec,
   getRequestBag,
   hostValidationMiddleware,
   inputRequired2 as inputRequired,
   inputResponse2 as inputResponse,
-  isInputRequiredResult2 as isInputRequiredResult,
+  isInputRequiredResult3 as isInputRequiredResult,
   jsonBodyMiddleware,
   matchesPath,
   matchesPathPrefix,