mcp-use 2.0.0-beta.2 → 2.0.0-beta.21

package/dist/fetch-app.d.ts

@@ -1,6 +1,23 @@
 import { type AuthInfo } from "@modelcontextprotocol/server";
 /** Web-standard request handler. */
 export type FetchHandler = (request: Request) => Promise<Response>;
+/** Request shapes accepted by {@link toFrameworkHandler}. */
+export type FrameworkRequestLike = Request | {
+    req: {
+        raw: Request;
+    };
+};
+/**
+ * Universal web handler mountable in Vercel, Hono, TanStack, and other
+ * fetch-native frameworks without `c.req.raw` boilerplate.
+ */
+export type FrameworkHandler = (input: FrameworkRequestLike) => Promise<Response>;
+/**
+ * Wrap a {@link FetchHandler} for framework duck-typing (Hono `Context`, etc.).
+ *
+ * @param fetch - Inner fetch handler produced by {@link MCPServer.getHandler}.
+ */
+export declare function toFrameworkHandler(fetch: FetchHandler): FrameworkHandler;
 /** Onion middleware over a {@link FetchHandler} terminal. */
 export type FetchMiddleware = (request: Request, next: () => Promise<Response>) => Promise<Response>;
 /** Per-request values stashed before the MCP handler runs. */
@@ -43,6 +60,32 @@ export declare function matchesPath(request: Request, path: string): boolean;
  * @param prefix - Path prefix without a trailing wildcard.
  */
 export declare function matchesPathPrefix(request: Request, prefix: string): boolean;
+/**
+ * Append a framework-owned child path beneath an MCP base path.
+ *
+ * Unlike string interpolation, this keeps the root base path from producing
+ * a double slash: `pathUnderBase("/", "inspector")` is `"/inspector"`.
+ *
+ * @param basePath - Valid MCP base path, including the root path `/`.
+ * @param childPath - Relative child path, with or without a leading slash.
+ * @returns Absolute pathname beneath `basePath`.
+ *
+ * @internal
+ */
+export declare function pathUnderBase(basePath: string, childPath: string): string;
+/**
+ * Classify a request as explicit browser HTML navigation.
+ *
+ * Only GET and HEAD requests whose Accept header names `text/html` with a
+ * non-zero quality value qualify. Wildcard-only and missing Accept headers
+ * remain available to protocol and health probes.
+ *
+ * @param request - Incoming request to classify.
+ * @returns Whether the request explicitly accepts HTML.
+ *
+ * @internal
+ */
+export declare function isHtmlNavigationRequest(request: Request): boolean;
 /**
  * Dispatch to the first matching route handler.
  *

package/dist/fetch-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-app.d.ts","sourceRoot":"","sources":["../src/fetch-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAC;AAEtC,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnE,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAO1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,GAAG,WAAW,EAAE,eAAe,EAAE,GAChC,YAAY,CAad;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC,EACF,QAAQ,GAAE,YACkC,GAC3C,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAkBpD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,eAAe,UAAO,GACrB,eAAe,CAWjB"}
+{"version":3,"file":"fetch-app.d.ts","sourceRoot":"","sources":["../src/fetch-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,8BAA8B,CAAC;AAEtC,oCAAoC;AACpC,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEnE,6DAA6D;AAC7D,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,oBAAoB,KACxB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAKxE;AAED,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,KAC1B,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAO1D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,YAAY,EACtB,GAAG,WAAW,EAAE,eAAe,EAAE,GAChC,YAAY,CAad;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAkBjE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC,EACF,QAAQ,GAAE,YACkC,GAC3C,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAkBpD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,eAAe,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,eAAe,UAAO,GACrB,eAAe,CAWjB"}

package/dist/index.d.ts

@@ -5,13 +5,14 @@
  * 2026-07-28 MCP protocol. See specs/SPEC.md for the phase plan and API contract.
  */
 export { MCPServer } from "./server.js";
-export { createMcpMount, mountMcp } from "./mount-mcp.js";
+export { createMcpMount } from "./mount-mcp.js";
 export type { MountMcpOptions, McpMount } from "./mount-mcp.js";
-export { composeFetch, getRequestBag, hostValidationMiddleware, jsonBodyMiddleware, matchesPath, matchesPathPrefix, originValidationMiddleware, pathnameOf, routeFetch, } from "./fetch-app.js";
-export type { FetchHandler, FetchMiddleware, RequestBag } from "./fetch-app.js";
+export { composeFetch, getRequestBag, hostValidationMiddleware, jsonBodyMiddleware, matchesPath, matchesPathPrefix, originValidationMiddleware, pathnameOf, routeFetch, toFrameworkHandler, } from "./fetch-app.js";
+export type { FetchHandler, FetchMiddleware, FrameworkHandler, FrameworkRequestLike, RequestBag, } from "./fetch-app.js";
 export { registerViews } from "./views/index.js";
 export { requestLogger } from "./logging.js";
 export type { LoggingOptions, LogLevel } from "./logging.js";
+export type { LandingPageOptions, LandingPagePrompt, LandingPageResource, LandingPageTool, } from "./landing.js";
 /**
  * Wire result shapes (re-exported from the SDK): callbacks return these raw
  * shapes directly — tools return {@link CallToolResult}, resources
@@ -19,6 +20,13 @@ export type { LoggingOptions, LogLevel } from "./logging.js";
  * framework-specific result layer.
  */
 export type { CallToolResult, ContentBlock, GetPromptResult, InputRequest, InputRequiredResult, InputResponses, PromptMessage, ReadResourceResult, } from "@modelcontextprotocol/server";
+/**
+ * Official SDK descriptor metadata contracts. Tools use
+ * {@link ToolAnnotations}; resources and resource templates use
+ * {@link Annotations}; every descriptor's extension `_meta` uses
+ * {@link MetaObject}.
+ */
+export type { Annotations, MetaObject, ToolAnnotations, } from "@modelcontextprotocol/server";
 /**
  * Official SDK helpers for authoring and reading multi-round-trip
  * `input_required` results.
@@ -33,11 +41,18 @@ export type { CompletionCallback, CompletionContext } from "./completable.js";
  * Implemented by zod v4, ArkType, Valibot, …
  */
 export type { StandardSchemaV1, StandardSchemaWithJSON, } from "@modelcontextprotocol/server";
-export type { InspectorOptions, ServerConfig } from "./config.js";
+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, 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";
 export type { InferToolInput, InferToolName, InferToolOutput, ToolCallback, ToolDefinition, ToolRef, ToolResult, ToolViewConfig, } from "./tools.js";
 export type { ExternalViewManifestEntry, InlineViewManifestEntry, UiPermissions, ViewManifestEntry, ViewsManifest, } from "./views/index.js";
-export type { InferTemplateParams, ResourceCallback, ResourceDefinition, ResourceTemplateCallback, ResourceTemplateDefinition, TemplateVariableValue, } from "./resources.js";
+export type { InferTemplateParams, ResourceCallback, ResourceDefinition, ResourceTemplateCallback, ResourceTemplateCompleter, ResourceTemplateCompletions, ResourceTemplateDefinition, TemplateVariableValue, } from "./resources.js";
 export type { InferPromptInput, PromptCallback, PromptDefinition, } from "./prompts.js";
+export type { ProxyConnection, ProxyHttpConfig, ProxyProgress, ProxyPrompt, ProxyRequestOptions, ProxyResource, ProxyServerConfig, ProxyTool, } from "./mcp-proxy.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,0BAA0B,EAC1B,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;GAKG;AACH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC;;;GAGG;AACH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;GAKG;AACH,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,SAAS,EACT,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,EACd,OAAO,EACP,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}