mcp-use 2.0.0-beta.28 → 2.0.0-beta.29

package/dist/{chunk-26JBVQUY.js → chunk-QKJJ6DWK.js}

@@ -26,12 +26,6 @@ import {
   hostHeaderValidationResponse,
   originValidationResponse
 } from "@modelcontextprotocol/server";
-function toFrameworkHandler(fetch) {
-  return (input) => {
-    const request = input instanceof Request ? input : input.req.raw;
-    return fetch(request);
-  };
-}
 var requestBags = /* @__PURE__ */ new WeakMap();
 function getRequestBag(request) {
   let bag = requestBags.get(request);
@@ -88,16 +82,6 @@ function isHtmlNavigationRequest(request) {
     });
   });
 }
-function routeFetch(routes, fallback = async () => new Response("Not Found", { status: 404 })) {
-  return async (request) => {
-    for (const route of routes) {
-      if (route.match(request)) {
-        return route.handler(request);
-      }
-    }
-    return fallback(request);
-  };
-}
 function jsonBodyMiddleware() {
   return async (request, next) => {
     const bag = getRequestBag(request);
@@ -177,7 +161,6 @@ function authInfoFromRequest(request) {
 }
 
 export {
-  toFrameworkHandler,
   getRequestBag,
   composeFetch,
   pathnameOf,
@@ -185,7 +168,6 @@ export {
   matchesPathPrefix,
   pathUnderBase,
   isHtmlNavigationRequest,
-  routeFetch,
   jsonBodyMiddleware,
   hostValidationMiddleware,
   originValidationMiddleware,

package/dist/config.d.ts

@@ -107,8 +107,8 @@ interface BaseServerConfig {
      * binds get DNS-rebinding protection (`Host` on every request; `Origin`
      * only on non-GET/HEAD) automatically. Set `"0.0.0.0"` to serve publicly — behind a platform
      * edge (Railway, Fly, …) nothing more is needed, since the edge only
-     * routes hostnames assigned to the deployment. Ignored by `getHandler()`,
-     * which never binds.
+     * routes hostnames assigned to the deployment. Ignored by `server.fetch`,
+     * which never binds a socket.
      */
     host?: string;
     /**
@@ -123,7 +123,7 @@ interface BaseServerConfig {
      * protection), e.g. `["api.example.com"]`. Port-agnostic and additive:
      * localhost-class hostnames stay allowed, so local runs keep working
      * unmodified. Setting this also turns Host validation on for
-     * `getHandler()`, which otherwise applies none.
+     * `server.fetch`, which otherwise applies none.
      */
     allowedHosts?: string[];
     /**
@@ -186,7 +186,7 @@ interface BaseServerConfig {
      */
     requestState?: ServerOptions["requestState"];
     /**
-     * Optional CORS headers on every route served by `getHandler()` / `listen()`
+     * Optional CORS headers on every route served by `server.fetch` / `listen()`
      * (MCP endpoint, view assets, landing page, OAuth metadata). Off when omitted.
      *
      * Pair with {@link BaseServerConfig.allowedOrigins | allowedOrigins} for
@@ -209,7 +209,7 @@ interface BaseServerConfig {
     cors?: CorsOptions;
 }
 /**
- * CORS configuration for routes owned by mcp-use (`getHandler()` / `listen()`).
+ * CORS configuration for routes owned by the Hono application.
  *
  * Omit `cors` entirely for the current no-CORS behavior. Pass `cors: {}` to
  * enable with defaults (reflects the request `Origin` when present; wildcard

package/dist/context.d.ts

@@ -1,4 +1,5 @@
 import { type InputRequiredResult, type RequestStateAccessor, type ServerContext, type StandardSchemaWithJSON } from "@modelcontextprotocol/server";
+import type { Context, Env, HonoRequest as HonoRequestType } from "hono";
 /**
  * Per-request client capability queries.
  *
@@ -79,11 +80,17 @@ export type OAuthAuth<TUser> = {
     expiresAt: number;
     resource?: URL;
 };
-type RequestContextBase = {
+type RequestContextBase<TEnv extends Env> = Omit<Context<TEnv>, "req"> & {
     /** Aborted when the client cancels the request or the connection drops. */
     signal: AbortSignal;
-    /** The originating HTTP request, when served over HTTP. */
-    request?: Request;
+    /** Hono request for the originating HTTP exchange. Its raw Web Request is available as `request.raw`. */
+    request?: HonoRequestType;
+    /**
+     * Deprecated v1-compatible alias for {@link RequestContext.request}.
+     *
+     * @deprecated Use `request` instead.
+     */
+    req?: HonoRequestType;
     /** Per-request client capability queries. */
     client: RequestClientContext;
     /** Request or read a keyed form- or URL-mode elicitation. */
@@ -112,9 +119,9 @@ type RequestContextBase = {
 /**
  * Per-request callback context, authenticated when OAuth is configured.
  */
-export type RequestContext<TUser = never, HasOAuth extends boolean = false> = HasOAuth extends true ? RequestContextBase & {
+export type RequestContext<TUser = never, HasOAuth extends boolean = false, TEnv extends Env = Env> = HasOAuth extends true ? RequestContextBase<TEnv> & {
     auth: OAuthAuth<TUser>;
-} : RequestContextBase & {
+} : RequestContextBase<TEnv> & {
     auth?: never;
 };
 /**
@@ -123,7 +130,7 @@ export type RequestContext<TUser = never, HasOAuth extends boolean = false> = Ha
  *
  * @internal
  */
-export declare function toRequestContext(ctx: ServerContext): RequestContext<never, false>;
+export declare function toRequestContext<TEnv extends Env = Env>(ctx: ServerContext): RequestContext<never, false, TEnv>;
 /** @internal Projects mapped OAuth auth information into callback context. */
-export declare function toAuthenticatedRequestContext<TUser>(ctx: ServerContext): RequestContext<TUser, true>;
+export declare function toAuthenticatedRequestContext<TUser, TEnv extends Env = Env>(ctx: ServerContext): RequestContext<TUser, true, TEnv>;
 export {};

package/dist/fetch-app.d.ts

@@ -1,23 +1,7 @@
 import { type AuthInfo } from "@modelcontextprotocol/server";
+import type { Context, Env } from "hono";
 /** 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. */
@@ -26,6 +10,8 @@ export interface RequestBag {
     parsedBody?: unknown;
     /** Verified OAuth identity forwarded to the SDK handler. */
     authInfo?: AuthInfo;
+    /** Hono context associated with this request while it traverses the app. */
+    honoContext?: Context<Env>;
 }
 /**
  * Mutable per-request bag; created on first access.
@@ -86,16 +72,6 @@ export declare function pathUnderBase(basePath: string, childPath: string): stri
  * @internal
  */
 export declare function isHtmlNavigationRequest(request: Request): boolean;
-/**
- * Dispatch to the first matching route handler.
- *
- * @param routes - Ordered route table; first match wins.
- * @param fallback - Handler when nothing matches.
- */
-export declare function routeFetch(routes: Array<{
-    match: (request: Request) => boolean;
-    handler: FetchHandler;
-}>, fallback?: FetchHandler): FetchHandler;
 /**
  * Parse JSON bodies once and stash them in the request bag.
  */

package/dist/index.d.ts

@@ -1,24 +1,27 @@
 /**
- * `mcp-use` — MCP server framework on the official v2 SDK (fetch-native).
+ * `mcp-use` — MCP server framework on the official v2 SDK, with a Hono HTTP
+ * application and a Web-standard Fetch serving boundary.
  *
  * Greenfield rebuild of the mcp-use server package against the stateless
  * 2026-07-28 MCP protocol. See specs/SPEC.md for the phase plan and API contract.
  */
 export { MCPServer } from "./server.js";
-export type { ListenOptions, ListenRoute } from "./server.js";
+export type { ListenOptions } from "./server.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, toFrameworkHandler, } from "./fetch-app.js";
-export type { FetchHandler, FetchMiddleware, FrameworkHandler, FrameworkRequestLike, RequestBag, } from "./fetch-app.js";
+export { composeFetch, getRequestBag, hostValidationMiddleware, jsonBodyMiddleware, matchesPath, matchesPathPrefix, originValidationMiddleware, pathnameOf, } from "./fetch-app.js";
+export type { FetchHandler, FetchMiddleware, 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
- * {@link ReadResourceResult}, prompts {@link GetPromptResult}. There is no
- * framework-specific result layer.
+ * Wire result shapes (re-exported from the SDK): prefer returning these raw
+ * shapes from callbacks — tools {@link CallToolResult}, resources
+ * {@link ReadResourceResult}, prompts {@link GetPromptResult}. Deprecated
+ * response helpers (`text`, `object`, …) are thin shims that produce the same
+ * tool envelope; resource/prompt registration still converts helper-shaped
+ * returns for upgrade compatibility.
  */
 export type { CallToolResult, ContentBlock, GetPromptResult, InputRequest, InputRequiredResult, InputResponses, PromptMessage, ReadResourceResult, } from "@modelcontextprotocol/server";
 /**
@@ -55,4 +58,14 @@ export type { InferToolInput, InferToolName, InferToolOutput, ToolCallback, Tool
 export type { ExternalViewManifestEntry, InlineViewManifestEntry, UiPermissions, ViewManifestEntry, ViewsManifest, } from "./views/index.js";
 export type { InferTemplateParams, ResourceCallback, ResourceDefinition, ResourceTemplateCallback, ResourceTemplateCompleter, ResourceTemplateCompletions, ResourceTemplateDefinition, TemplateVariableValue, } from "./resources.js";
 export type { InferPromptInput, PromptCallback, PromptDefinition, } from "./prompts.js";
+/**
+ * @deprecated Prefer raw {@link CallToolResult} / {@link ReadResourceResult} /
+ * {@link GetPromptResult} returns. These helpers remain for upgrade
+ * compatibility and map to the official wire envelopes.
+ */
+export { array, audio, binary, css, error, html, image, javascript, markdown, mix, object, resource, text, widget, xml, } from "./response-helpers.js";
+/**
+ * @deprecated Prefer raw wire result types from the package root.
+ */
+export type { ToolContentResult, TypedCallToolResult, WidgetResponseConfig, } from "./response-helpers.js";
 export type { ProxyConnection, ProxyHttpConfig, ProxyProgress, ProxyPrompt, ProxyRequestOptions, ProxyResource, ProxyServerConfig, ProxyTool, } from "./mcp-proxy.js";