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

package/dist/mcp-proxy.d.ts

@@ -0,0 +1,153 @@
+import type { CallToolResult, GetPromptResult, InputRequiredResult, PromptArgument, ReadResourceResult, ToolAnnotations } from "@modelcontextprotocol/server";
+import type { PromptCallback, PromptDefinition } from "./prompts.js";
+import type { ResourceCallback, ResourceDefinition } from "./resources.js";
+import type { ToolCallback, ToolDefinition } from "./tools.js";
+/** HTTP connection settings accepted by {@link MCPServer.proxy}. */
+export interface ProxyHttpConfig {
+    /** Upstream MCP endpoint URL. */
+    url: string;
+    /** Extra headers sent on every upstream request. */
+    headers?: Record<string, string>;
+    /** Bearer token sent to the upstream server. */
+    authToken?: string;
+    /** Connection timeout in milliseconds. */
+    timeout?: number;
+    /** Fetch implementation used for upstream HTTP requests. */
+    fetch?: typeof fetch;
+    /** Protocol negotiation mode forwarded to `@mcp-use/client`. */
+    protocolNegotiation?: "auto" | "legacy" | {
+        pin: string;
+    };
+}
+/** Connection settings for one upstream server. */
+export type ProxyServerConfig = ProxyHttpConfig;
+/** Progress payload received while a proxied tool is running. */
+export interface ProxyProgress {
+    /** Completed work units. */
+    progress: number;
+    /** Total work units, when known. */
+    total?: number | undefined;
+    /** Human-readable progress detail. */
+    message?: string | undefined;
+}
+/** Request controls used when forwarding calls to an upstream connection. */
+export interface ProxyRequestOptions {
+    /** Aborts the upstream request when the downstream request is cancelled. */
+    signal?: AbortSignal;
+    /** Receives upstream progress notifications. */
+    onprogress?: (progress: ProxyProgress) => void;
+}
+/** Structural connection contract accepted by the low-level proxy overload. */
+export interface ProxyConnection {
+    /** Negotiated metadata used to derive the automatic capability namespace. */
+    readonly info: {
+        server: {
+            name: string;
+        };
+    };
+    /** Whether the upstream advertised a named MCP capability. */
+    supports?(capability: string): boolean;
+    /** List upstream tools. */
+    listTools(): Promise<ProxyTool[]>;
+    /** Forward a tool call. */
+    callTool(name: string, args?: Record<string, unknown>, options?: ProxyRequestOptions): Promise<CallToolResult | InputRequiredResult>;
+    /** List upstream resources, including pagination when supported. */
+    listAllResources?(): Promise<{
+        resources: ProxyResource[];
+    }>;
+    /** List one page of upstream resources. */
+    listResources?(): Promise<{
+        resources: ProxyResource[];
+    }>;
+    /** Read an upstream resource. */
+    readResource(uri: string, options?: ProxyRequestOptions): Promise<ReadResourceResult>;
+    /** List upstream prompts. */
+    listPrompts(): Promise<{
+        prompts: ProxyPrompt[];
+    }>;
+    /** Render an upstream prompt. */
+    getPrompt(name: string, args: Record<string, unknown>): Promise<GetPromptResult>;
+}
+/** Tool metadata consumed while introspecting an upstream connection. */
+export interface ProxyTool {
+    /** Upstream tool name. */
+    name: string;
+    /** Human-readable tool title. */
+    title?: string | undefined;
+    /** LLM-facing tool description. */
+    description?: string | undefined;
+    /** Upstream input JSON Schema. */
+    inputSchema?: Record<string, unknown> | undefined;
+    /** Upstream output JSON Schema. */
+    outputSchema?: Record<string, unknown> | undefined;
+    /** Upstream behavioral hints. */
+    annotations?: ToolAnnotations | undefined;
+}
+/** Resource metadata consumed while introspecting an upstream connection. */
+export interface ProxyResource {
+    /** Upstream resource name. */
+    name: string;
+    /** Original upstream resource URI. */
+    uri: string;
+    /** Human-readable resource title. */
+    title?: string | undefined;
+    /** Human-readable resource description. */
+    description?: string | undefined;
+    /** Resource media type. */
+    mimeType?: string | undefined;
+}
+/** Prompt metadata consumed while introspecting an upstream connection. */
+export interface ProxyPrompt {
+    /** Upstream prompt name. */
+    name: string;
+    /** Human-readable prompt title. */
+    title?: string | undefined;
+    /** Human-readable prompt description. */
+    description?: string | undefined;
+    /** String arguments accepted by the prompt. */
+    arguments?: PromptArgument[] | undefined;
+}
+/** Registration surface used while mounting proxied capabilities. @internal */
+export interface ProxyMountHost {
+    /** Whether the parent server has mounted its handler. */
+    isStarted(): boolean;
+    /** Whether a tool name is already registered. */
+    hasTool(name: string): boolean;
+    /** Whether a resource name is already registered. */
+    hasResource(name: string): boolean;
+    /** Whether a prompt name is already registered. */
+    hasPrompt(name: string): boolean;
+    /** Register a proxied tool. */
+    registerTool(definition: ToolDefinition, callback: ToolCallback): void;
+    /** Register a proxied resource. */
+    registerResource(definition: ResourceDefinition, callback: ResourceCallback): void;
+    /** Register a proxied prompt. */
+    registerPrompt(definition: PromptDefinition, callback: PromptCallback): void;
+    /** Track a proxy client owned by the parent server. */
+    trackOwner(owner: {
+        close(): Promise<void>;
+    }): void;
+}
+/** Convert a missing optional-client import into the proxy install error. @internal */
+export declare function proxyClientInstallError(error: unknown): Error | undefined;
+/**
+ * Mount one existing upstream connection on a parent server.
+ *
+ * @param host - Parent server registration surface.
+ * @param connection - Ready `@mcp-use/client` v2 connection.
+ * @internal
+ */
+export declare function mountProxyConnection(host: ProxyMountHost, connection: ProxyConnection): Promise<void>;
+/**
+ * Connect and mount namespace-keyed upstream servers through
+ * `@mcp-use/client` v2.
+ *
+ * @param host - Parent server registration surface.
+ * @param servers - Namespace-keyed upstream client configuration.
+ *
+ * @internal
+ */
+export declare function mountProxyServers(host: ProxyMountHost, servers: Record<string, ProxyServerConfig>): Promise<void>;
+/** Determine whether a proxy argument is an existing connection. @internal */
+export declare function isProxyConnection(value: unknown): value is ProxyConnection;
+//# sourceMappingURL=mcp-proxy.d.ts.map

package/dist/mcp-proxy.d.ts.map

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

package/dist/middleware/cors.d.ts

@@ -0,0 +1,11 @@
+import type { CorsOptions } from "../config.js";
+import type { FetchMiddleware } from "../fetch-app.js";
+/**
+ * Fetch middleware that adds CORS headers to every response.
+ *
+ * @internal Wired from {@link MCPServer} when `ServerConfig.cors` is set.
+ */
+export declare function corsFetchMiddleware(options: CorsOptions): FetchMiddleware;
+/** Whether global CORS middleware owns response headers for view assets. */
+export declare function isGlobalCorsEnabled(cors: CorsOptions | undefined): boolean;
+//# sourceMappingURL=cors.d.ts.map

package/dist/middleware/cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../src/middleware/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAgFvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CA0BzE;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAE1E"}

package/dist/middleware/mcp-middleware.d.ts

@@ -0,0 +1,179 @@
+import type { AuthInfo, HandlerResultTypeMap, RequestTypeMap, ResultTypeMap } from "@modelcontextprotocol/server";
+declare const MCP_MIDDLEWARE_METHODS: readonly ["tools/call", "tools/list", "resources/read", "resources/list", "prompts/get", "prompts/list"];
+/** MCP methods currently intercepted by {@link MCPServer.use}. */
+export type McpMiddlewareMethod = (typeof MCP_MIDDLEWARE_METHODS)[number];
+/** Params exposed by the SDK for a particular MCP request method. */
+export type McpMiddlewareParams<M extends McpMiddlewareMethod> = RequestTypeMap[M] extends {
+    params?: infer P;
+} ? NonNullable<P> : Record<string, never>;
+/**
+ * Method-specific params and middleware result types.
+ *
+ * List middleware intentionally operates on item arrays rather than protocol
+ * result envelopes. The server wrapper preserves the envelope around the
+ * transformed array.
+ */
+export interface McpMiddlewareOperationMap {
+    "tools/call": {
+        params: McpMiddlewareParams<"tools/call">;
+        result: HandlerResultTypeMap["tools/call"];
+    };
+    "tools/list": {
+        params: McpMiddlewareParams<"tools/list">;
+        result: ResultTypeMap["tools/list"]["tools"];
+    };
+    "resources/read": {
+        params: McpMiddlewareParams<"resources/read">;
+        result: HandlerResultTypeMap["resources/read"];
+    };
+    "resources/list": {
+        params: McpMiddlewareParams<"resources/list">;
+        result: ResultTypeMap["resources/list"]["resources"];
+    };
+    "prompts/get": {
+        params: McpMiddlewareParams<"prompts/get">;
+        result: HandlerResultTypeMap["prompts/get"];
+    };
+    "prompts/list": {
+        params: McpMiddlewareParams<"prompts/list">;
+        result: ResultTypeMap["prompts/list"]["prompts"];
+    };
+}
+/** Result exposed to middleware for a particular MCP method. */
+export type McpMiddlewareResult<M extends McpMiddlewareMethod> = McpMiddlewareOperationMap[M]["result"];
+/**
+ * Rebuild an SDK request with the params currently held by middleware.
+ *
+ * Middleware may replace `ctx.params`, so forwarding the request object that
+ * was captured before the chain ran would silently discard that replacement.
+ * @internal
+ */
+export declare function withMcpMiddlewareParams<M extends McpMiddlewareMethod>(request: unknown, params: McpMiddlewareOperationMap[M]["params"]): RequestTypeMap[M];
+interface MiddlewareContextCommon {
+    /** The originating HTTP request, when this operation is served over HTTP. */
+    request?: Request;
+    /** Session info when the underlying transport provides a session ID. */
+    session?: {
+        sessionId: string;
+    };
+    /** OAuth info extracted from the validated access token. */
+    auth?: AuthInfo;
+    /** Shared state for middleware participating in this request. */
+    state: Map<string, unknown>;
+}
+/**
+ * Context passed to MCP middleware.
+ *
+ * The conditional form preserves the correlation between `method` and
+ * `params` when more than one method is represented.
+ */
+export type MiddlewareContext<M extends McpMiddlewareMethod = McpMiddlewareMethod> = M extends McpMiddlewareMethod ? MiddlewareContextCommon & {
+    method: M;
+    params: McpMiddlewareOperationMap[M]["params"];
+} : never;
+/** Preferred explicit name for the method-correlated middleware context. */
+export type McpMiddlewareContext<M extends McpMiddlewareMethod = McpMiddlewareMethod> = MiddlewareContext<M>;
+/** Context with narrowed params for `tools/call`. */
+export type ToolsCallMiddlewareContext = MiddlewareContext<"tools/call">;
+/** Context with narrowed params for `tools/list`. */
+export type ToolsListMiddlewareContext = MiddlewareContext<"tools/list">;
+/** Context with narrowed params for `resources/read`. */
+export type ResourcesReadMiddlewareContext = MiddlewareContext<"resources/read">;
+/** Context with narrowed params for `resources/list`. */
+export type ResourcesListMiddlewareContext = MiddlewareContext<"resources/list">;
+/** Context with narrowed params for `prompts/get`. */
+export type PromptsGetMiddlewareContext = MiddlewareContext<"prompts/get">;
+/** Context with narrowed params for `prompts/list`. */
+export type PromptsListMiddlewareContext = MiddlewareContext<"prompts/list">;
+/** Map retained for compatibility and convenient indexed lookup. */
+export type McpMiddlewarePatternMap = {
+    [M in McpMiddlewareMethod]: MiddlewareContext<M>;
+};
+/** Continue the middleware chain with the result type for method `M`. */
+export type McpMiddlewareNext<M extends McpMiddlewareMethod> = () => Promise<McpMiddlewareResult<M>>;
+/** Middleware for one exact MCP method. */
+export type McpExactMiddlewareFn<M extends McpMiddlewareMethod> = (ctx: MiddlewareContext<M>, next: McpMiddlewareNext<M>) => Promise<McpMiddlewareResult<M>>;
+/**
+ * Type-preserving middleware over every wrapped MCP method.
+ *
+ * The global wildcard cannot inspect or replace a method-specific result. Its `next`
+ * resolves after downstream middleware, and the composer propagates that
+ * downstream result unchanged. It must call `next()` or throw.
+ */
+export type McpMiddlewareFn<Methods extends McpMiddlewareMethod = McpMiddlewareMethod> = (ctx: MiddlewareContext<Methods>, next: () => Promise<void>) => Promise<void>;
+/** Exact MCP middleware methods plus the global pass-through wildcard. */
+export type McpMiddlewarePatternBody = McpMiddlewareMethod | "*";
+/** Canonical `mcp:` patterns plus prefixless compatibility forms. */
+export type McpMiddlewarePattern = McpMiddlewarePatternBody | `mcp:${McpMiddlewarePatternBody}`;
+/** Observer patterns additionally support grouping related MCP methods. */
+export type McpEventPatternBody = McpMiddlewarePatternBody | "tools/*" | "resources/*" | "prompts/*";
+type McpEventBasePattern = McpEventPatternBody | `mcp:${McpEventPatternBody}`;
+type StripMcpPrefix<P extends string> = P extends `mcp:${infer Body}` ? Body : P;
+/** Methods selected by an MCP middleware or observer pattern. */
+export type McpMiddlewareMethodsForPattern<P extends string> = StripMcpPrefix<P> extends infer Body ? Body extends McpMiddlewareMethod ? Body : Body extends "tools/*" ? Extract<McpMiddlewareMethod, `tools/${string}`> : Body extends "resources/*" ? Extract<McpMiddlewareMethod, `resources/${string}`> : Body extends "prompts/*" ? Extract<McpMiddlewareMethod, `prompts/${string}`> : Body extends "*" ? McpMiddlewareMethod : never : never;
+/** Infer an exact or type-preserving wildcard handler from pattern `P`. */
+export type McpMiddlewareFnFor<P extends McpMiddlewarePattern> = StripMcpPrefix<P> extends infer Body ? Body extends McpMiddlewareMethod ? McpExactMiddlewareFn<Body> : McpMiddlewareFn<McpMiddlewareMethodsForPattern<P>> : never;
+/**
+ * Type-erased middleware adapter stored after registration.
+ *
+ * Exact handlers and the global wildcard are adapted to this common callable
+ * shape before insertion, following the SDK's request-handler storage model.
+ * @internal
+ */
+export interface McpMiddlewareEntry {
+    pattern: string;
+    handler: (ctx: MiddlewareContext, next: () => Promise<unknown>) => Promise<unknown>;
+}
+/**
+ * Adapt a public method-correlated handler for type-erased internal storage.
+ *
+ * The overload retains the public pattern/handler correlation. The broad
+ * implementation signature is the deliberate erasure boundary, like the
+ * official SDK's `setRequestHandler` implementation.
+ */
+export declare function createMcpMiddlewareEntry<P extends McpMiddlewarePattern>(pattern: P, handler: McpMiddlewareFnFor<P>): McpMiddlewareEntry;
+/** Phase for MCP observer event listeners registered via `server.on()`. */
+export type McpEventPhase = "before" | "complete";
+/** Read-only observer context correlated by MCP method. */
+export type ReadonlyMiddlewareContext<M extends McpMiddlewareMethod = McpMiddlewareMethod> = M extends McpMiddlewareMethod ? Omit<MiddlewareContext<M>, "params" | "request" | "state"> & {
+    readonly params: Readonly<McpMiddlewareOperationMap[M]["params"]>;
+    /** The originating HTTP request, when this operation is served over HTTP. */
+    readonly request?: Request;
+    readonly state: ReadonlyMap<string, unknown>;
+} : never;
+/** Read-only observer invoked before an MCP handler runs. */
+export type McpEventListenerFn<Methods extends McpMiddlewareMethod = McpMiddlewareMethod> = <M extends Methods>(ctx: ReadonlyMiddlewareContext<M>) => void;
+/** Read-only observer invoked after an MCP handler completes. */
+export type McpCompleteEventListenerFn<Methods extends McpMiddlewareMethod = McpMiddlewareMethod> = <M extends Methods>(ctx: ReadonlyMiddlewareContext<M>, result: McpMiddlewareResult<M>) => void;
+type McpExactEventListenerFn<M extends McpMiddlewareMethod> = (ctx: ReadonlyMiddlewareContext<M>) => void;
+type McpExactCompleteEventListenerFn<M extends McpMiddlewareMethod> = (ctx: ReadonlyMiddlewareContext<M>, result: McpMiddlewareResult<M>) => void;
+/** MCP observer pattern, optionally targeting the completion phase. */
+export type McpEventPattern = McpEventBasePattern | `${McpEventBasePattern}:complete`;
+type StripCompleteSuffix<P extends string> = P extends `${infer Body}:complete` ? Body : P;
+/** Infer a typed before/complete observer from event pattern `P`. */
+export type McpEventListenerFnFor<P extends McpEventPattern> = StripCompleteSuffix<StripMcpPrefix<P>> extends infer Body ? Body extends McpMiddlewareMethod ? P extends `${string}:complete` ? McpExactCompleteEventListenerFn<Body> : McpExactEventListenerFn<Body> : P extends `${string}:complete` ? McpCompleteEventListenerFn<McpMiddlewareMethodsForPattern<StripCompleteSuffix<P>>> : McpEventListenerFn<McpMiddlewareMethodsForPattern<StripCompleteSuffix<P>>> : never;
+/** Internal type-erased observer entry. @internal */
+export interface McpEventListenerEntry {
+    pattern: string;
+    phase: McpEventPhase;
+    handler: (ctx: ReadonlyMiddlewareContext, result?: unknown) => void;
+}
+/** Adapt a public method-correlated observer for type-erased storage. */
+export declare function createMcpEventListenerEntry<P extends McpEventPattern>(pattern: P, handler: McpEventListenerFnFor<P>): McpEventListenerEntry;
+/** Test whether a registered middleware or observer pattern matches a method. */
+export declare function matchesPattern(pattern: string, method: string): boolean;
+/** Compose matching middleware in FIFO registration order. */
+export declare function composeMiddleware<M extends McpMiddlewareMethod>(entries: McpMiddlewareEntry[], method: M, innerFn: () => Promise<McpMiddlewareResult<M>>): (ctx: MiddlewareContext<M>) => Promise<McpMiddlewareResult<M>>;
+/** Build a read-only snapshot of middleware context for observer events. */
+export declare function freezeMiddlewareContext<M extends McpMiddlewareMethod>(ctx: MiddlewareContext<M>): ReadonlyMiddlewareContext<M>;
+/** Run before/complete observers around a method-correlated middleware chain. */
+export declare function runMcpOperation<M extends McpMiddlewareMethod>(middlewares: McpMiddlewareEntry[], events: McpEventListenerEntry[], method: M, ctx: MiddlewareContext<M>, innerFn: () => Promise<McpMiddlewareResult<M>>): Promise<McpMiddlewareResult<M>>;
+/** Strip `mcp:` prefix and optional `:complete` suffix from event patterns. */
+export declare function parseMcpPattern(raw: string): {
+    pattern: string;
+    phase: McpEventPhase;
+};
+/** Normalize middleware pattern strings by stripping the `mcp:` prefix. */
+export declare function normalizeMcpMiddlewarePattern(raw: string): string;
+export {};
+//# sourceMappingURL=mcp-middleware.d.ts.map

package/dist/middleware/mcp-middleware.d.ts.map

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

package/dist/mount-mcp.d.ts

@@ -44,8 +44,4 @@ export interface McpMount {
  * ```
  */
 export declare function createMcpMount(factory: McpServerFactory, options?: MountMcpOptions): McpMount;
-/**
- * @deprecated Use {@link createMcpMount} — returns the same mount without Hono.
- */
-export declare function mountMcp(factory: McpServerFactory, options?: MountMcpOptions): McpMount;
 //# sourceMappingURL=mount-mcp.d.ts.map

package/dist/mount-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-mcp.d.ts","sourceRoot":"","sources":["../src/mount-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/E,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAiDV;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAEV"}
+{"version":3,"file":"mount-mcp.d.ts","sourceRoot":"","sources":["../src/mount-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,uBAAuB,EAC5B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM/E,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,SAAS,CAAC;CACvD;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,OAAO,EAAE,cAAc,CAAC;IACxB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAiDV"}

package/dist/next/config.d.ts

@@ -0,0 +1,39 @@
+interface NextHeader {
+    key: string;
+    value: string;
+}
+interface NextHeaderRule {
+    source: string;
+    headers: NextHeader[];
+}
+/** Minimal structural Next.js config type, avoiding a runtime Next dependency. */
+export interface NextConfigLike {
+    /** Preserve arbitrary Next.js settings while augmenting the fields we use. */
+    [key: string]: unknown;
+    headers?: () => NextHeaderRule[] | Promise<NextHeaderRule[]>;
+    outputFileTracingIncludes?: Record<string, string[]>;
+}
+/** Options for {@link withMcpUse}. */
+export interface WithMcpUseOptions {
+    /** Authored MCP server entry, relative to `projectRoot`. */
+    entry?: string;
+    /** Conventional MCP source directory containing the entry and `views/`. */
+    mcpDir?: string;
+    /** Explicit views directory, relative to `projectRoot`. */
+    viewsDir?: string;
+    /** MCP route mounted by the application. Defaults to `/api/mcp`. */
+    basePath?: string;
+    /** Next.js project root. Defaults to `process.cwd()`. */
+    projectRoot?: string;
+}
+/** @internal Exported for focused composition tests, not from `mcp-use/next`. */
+export declare function composeNextConfig<T extends NextConfigLike>(nextConfig: T, basePath: string): T & NextConfigLike;
+/**
+ * Add mcp-use build, CORS, and serverless tracing to a Next.js config.
+ *
+ * The MCP build runs when Next evaluates `next.config`, for both development
+ * and production builds. This removes the need for a separate prebuild script.
+ */
+export declare function withMcpUse<T extends NextConfigLike = NextConfigLike>(nextConfig?: T, options?: WithMcpUseOptions): Promise<T & NextConfigLike>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/next/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/next/config.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7D,yBAAyB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtD;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAkFD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,cAAc,EACxD,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,MAAM,GACf,CAAC,GAAG,cAAc,CA0BpB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,EACxE,UAAU,GAAE,CAAW,EACvB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,GAAG,cAAc,CAAC,CAO7B"}

package/dist/next/handler.d.ts

@@ -0,0 +1,17 @@
+import type { MCPServer } from "../server.js";
+/** Route Handler exports returned by {@link createNextHandler}. */
+export interface NextMcpHandlers {
+    GET(request: Request): Promise<Response>;
+    POST(request: Request): Promise<Response>;
+    DELETE(request: Request): Promise<Response>;
+    OPTIONS(request: Request): Promise<Response>;
+}
+/**
+ * Create App Router method exports for an authored MCP server.
+ *
+ * The generated artifact contains only view registration data; application
+ * source continues to import its own server module. Initialization is lazy so
+ * importing a route during `next build` does not perform filesystem I/O.
+ */
+export declare function createNextHandler<TUser>(server: MCPServer<TUser>): NextMcpHandlers;
+//# sourceMappingURL=handler.d.ts.map

package/dist/next/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/next/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C;AAoDD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EACrC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,GACvB,eAAe,CAwDjB"}

package/dist/next/index.d.ts

@@ -0,0 +1,5 @@
+export { createNextHandler } from "./handler.js";
+export type { NextMcpHandlers } from "./handler.js";
+export { withMcpUse } from "./config.js";
+export type { NextConfigLike, WithMcpUseOptions } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/next/index.js

@@ -0,0 +1,172 @@
+// src/next/handler.ts
+import { readFile } from "fs/promises";
+import { join } from "path";
+function isViewManifestEntry(value) {
+  if (typeof value !== "object" || value === null || !("kind" in value)) {
+    return false;
+  }
+  if (value.kind === "inline") {
+    return "js" in value && typeof value.js === "string" && "css" in value && typeof value.css === "string";
+  }
+  return value.kind === "external" && "entry" in value && typeof value.entry === "string" && "css" in value && Array.isArray(value.css) && value.css.every((item) => typeof item === "string") && (!("scripts" in value) || Array.isArray(value.scripts) && value.scripts.every((item) => typeof item === "string"));
+}
+function parseBuildManifest(raw, manifestPath) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(
+      `Invalid mcp-use build manifest at ${manifestPath}: ${reason}`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed) || !("views" in parsed) || typeof parsed.views !== "object" || parsed.views === null || Array.isArray(parsed.views) || !Object.values(parsed.views).every(isViewManifestEntry)) {
+    throw new Error(`Invalid mcp-use build manifest at ${manifestPath}.`);
+  }
+  return parsed.views;
+}
+function createNextHandler(server) {
+  const projectRoot = process.cwd();
+  const manifestPath = join(
+    process.cwd(),
+    ".mcp-use",
+    "build",
+    "manifest.json"
+  );
+  let handlerPromise;
+  const initialize = async () => {
+    let raw;
+    try {
+      raw = await readFile(manifestPath, "utf8");
+    } catch (error) {
+      const code = typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
+      if (code === "ENOENT") {
+        throw new Error(
+          `No mcp-use build found at ${manifestPath}. Wrap next.config with withMcpUse() before mounting this route.`
+        );
+      }
+      throw error;
+    }
+    server.__primeViews(parseBuildManifest(raw, manifestPath), {
+      projectRoot
+    });
+    return server.getHandler();
+  };
+  const handle = async (request) => {
+    handlerPromise ??= initialize();
+    return (await handlerPromise)(request);
+  };
+  const preflight = async () => new Response(null, {
+    status: 204,
+    headers: {
+      "Access-Control-Allow-Origin": "*",
+      "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
+      "Access-Control-Allow-Headers": "Authorization, Content-Type, Accept, Mcp-Protocol-Version, Mcp-Method, Mcp-Name, Mcp-Session-Id, Last-Event-ID",
+      "Access-Control-Expose-Headers": "Mcp-Session-Id"
+    }
+  });
+  return { GET: handle, POST: handle, DELETE: handle, OPTIONS: preflight };
+}
+
+// src/next/config.ts
+var DEFAULT_BASE_PATH = "/api/mcp";
+var BUILD_TRACE_GLOB = "./.mcp-use/build/**/*";
+var MCP_CORS_HEADERS = [
+  { key: "Access-Control-Allow-Origin", value: "*" },
+  {
+    key: "Access-Control-Allow-Methods",
+    value: "GET, POST, DELETE, OPTIONS"
+  },
+  {
+    key: "Access-Control-Allow-Headers",
+    value: "Authorization, Content-Type, Accept, Mcp-Protocol-Version, Mcp-Method, Mcp-Name, Mcp-Session-Id, Last-Event-ID"
+  },
+  { key: "Access-Control-Expose-Headers", value: "Mcp-Session-Id" }
+];
+function normalizeBasePath(value) {
+  const raw = value ?? DEFAULT_BASE_PATH;
+  if (!raw.startsWith("/") || raw === "/" || raw.includes(":")) {
+    throw new Error(
+      `withMcpUse basePath must be a concrete absolute path; received ${JSON.stringify(raw)}.`
+    );
+  }
+  return raw.replace(/\/+$/, "");
+}
+function mergeHeaders(existing, additions) {
+  const next = [...existing];
+  for (const header of additions) {
+    const index = next.findIndex(
+      (candidate) => candidate.key.toLowerCase() === header.key.toLowerCase()
+    );
+    if (index === -1) next.push(header);
+    else next[index] = header;
+  }
+  return next;
+}
+async function buildMcpProject(projectRoot, options) {
+  const { spawn } = process.getBuiltinModule(
+    "node:child_process"
+  );
+  const { fileURLToPath } = process.getBuiltinModule(
+    "node:url"
+  );
+  const cliEntry = fileURLToPath(new URL("../bin.js", import.meta.url));
+  const args = [cliEntry, "build"];
+  if (options.entry !== void 0) args.push("--entry", options.entry);
+  if (options.mcpDir !== void 0) args.push("--mcp-dir", options.mcpDir);
+  if (options.viewsDir !== void 0)
+    args.push("--views-dir", options.viewsDir);
+  await new Promise((resolvePromise, reject) => {
+    const child = spawn(process.execPath, args, {
+      cwd: projectRoot,
+      env: process.env,
+      stdio: "inherit"
+    });
+    child.once("error", reject);
+    child.once("exit", (code, signal) => {
+      if (code === 0) {
+        resolvePromise();
+        return;
+      }
+      reject(
+        new Error(
+          `mcp-use build failed${code === null ? ` with signal ${signal}` : ` with exit code ${code}`}.`
+        )
+      );
+    });
+  });
+}
+function composeNextConfig(nextConfig, basePath) {
+  const source = `${basePath}/:path*`;
+  const originalHeaders = nextConfig.headers?.bind(nextConfig);
+  const existingTrace = nextConfig.outputFileTracingIncludes ?? {};
+  const routeTrace = existingTrace[basePath] ?? [];
+  return {
+    ...nextConfig,
+    async headers() {
+      const rules = originalHeaders === void 0 ? [] : await originalHeaders();
+      const matchingIndex = rules.findIndex((rule) => rule.source === source);
+      if (matchingIndex === -1) {
+        return [...rules, { source, headers: MCP_CORS_HEADERS }];
+      }
+      return rules.map(
+        (rule, index) => index === matchingIndex ? { ...rule, headers: mergeHeaders(rule.headers, MCP_CORS_HEADERS) } : rule
+      );
+    },
+    outputFileTracingIncludes: {
+      ...existingTrace,
+      [basePath]: [.../* @__PURE__ */ new Set([...routeTrace, BUILD_TRACE_GLOB])]
+    }
+  };
+}
+async function withMcpUse(nextConfig = {}, options = {}) {
+  const basePath = normalizeBasePath(options.basePath);
+  const projectRoot = options.projectRoot ?? process.cwd();
+  await buildMcpProject(projectRoot, options);
+  return composeNextConfig(nextConfig, basePath);
+}
+export {
+  createNextHandler,
+  withMcpUse
+};
+//# sourceMappingURL=index.js.map