mcp-use 2.0.0-beta.9 → 2.0.1

package/README.md

@@ -0,0 +1,379 @@
+<div align="center">
+  <a href="https://mcp-use.com">
+    <img alt="mcp-use" src="./docs/logo/banner-mcp-use.webp" width="100%">
+  </a>
+  <br /><br />
+
+<div id="user-content-toc">
+  <ul align="center" style="list-style: none;">
+    <summary>
+      <h1>The TypeScript framework for MCP</h1>
+    <h3>Build, test, and ship MCP servers, ChatGPT plugins, Claude connectors</h3>
+    </summary>
+  </ul>
+</div>
+
+
+  <p>
+    Fully Typed, native Views and MCP Apps support, built-in Inspector and first class Agent experience.
+  </p>
+
+  <p>
+    <a href="https://docs.mcp-use.com/v2/typescript/getting-started/welcome"><strong>Documentation</strong></a>
+    · <a href="https://inspector.mcp-use.com/inspector"><strong>Inspector</strong></a>
+    · <a href="#examples"><strong>Examples</strong></a>
+    · <a href="https://manufact.com"><strong>Deploy</strong></a>
+  </p>
+
+  <p>
+    <a href="https://www.npmjs.com/package/mcp-use">
+      <img src="https://img.shields.io/npm/v/mcp-use.svg?label=npm&amp;color=orange" alt="npm version">
+    </a>
+    <a href="https://www.npmjs.com/package/mcp-use">
+      <img src="https://img.shields.io/npm/dw/mcp-use.svg" alt="npm downloads">
+    </a>
+    <a href="https://manufact.com">
+      <img src="https://img.shields.io/badge/made%20by-manufact.com-blue" alt="made by manufact.com">
+    </a>
+    <a href="https://github.com/mcp-use/mcp-use/blob/main/LICENSE">
+      <img src="https://img.shields.io/github/license/mcp-use/mcp-use" alt="MIT license">
+    </a>
+    <a href="https://discord.gg/XkNkSkMz3V">
+      <img src="https://dcbadge.limes.pink/api/server/XkNkSkMz3V?style=flat" alt="Discord">
+    </a>
+  </p>
+  <br /><br />
+</div>
+
+> [!NOTE]
+> **Migrating from v1? Give it to your agent:** [Read the migration guide →](https://docs.mcp-use.com/v2/server/migration)
+>
+> ```text
+> Migrate this mcp-use project to v2 following
+> https://docs.mcp-use.com/v2/typescript/server/migration
+> ```
+>
+> [Read the migration guide →](https://docs.mcp-use.com/v2/typescript/server/migration)
+
+## Get started
+
+### Start with your agent
+
+```text
+Build an MCP server: https://mcp-use.com/prompt.md
+```
+
+[Read the prompt →](https://mcp-use.com/prompt.md)
+
+### Start with code
+
+```bash
+npx -y create-mcp-use-app@latest
+```
+
+Run `npm run dev` in the generated project · open [`http://localhost:3000/mcp/inspector`](http://localhost:3000/mcp/inspector)
+
+[TS Docs](https://docs.mcp-use.com/v2/typescript/getting-started/welcome)
+
+## Everything you need to ship MCP
+
+<table>
+  <tr>
+    <td width="50%" valign="top">
+      <h3>Fully typed</h3>
+      <p>Zod schemas flow from tools to structured results, View props, and tool calls.</p>
+    </td>
+    <td width="50%" valign="top">
+      <h3>Native Views</h3>
+      <p>Bind React Views directly to tools and ship interactive apps without custom extension wiring.</p>
+    </td>
+  </tr>
+  <tr>
+    <td width="50%" valign="top">
+      <h3>Agent-first and headless</h3>
+      <p>Scaffold, invoke, inspect, screenshot, and deploy through your agent.</p>
+    </td>
+    <td width="50%" valign="top">
+      <h3>Built-in debugging tools</h3>
+      <p>Inspect tools and Views in the browser or headlessly through the CLI.</p>
+    </td>
+  </tr>
+</table>
+
+## Quickstart
+
+The scaffold gives you the server, TypeScript configuration, development scripts, Inspector, and a React view pipeline. Start it once and the MCP endpoint also serves a client-ready landing page with its connection URL and setup instructions.
+
+Replace its `index.ts` with a view-bound tool like this:
+
+<table><tr><td>
+<details>
+<summary><strong><code>index.ts</code></strong> — Server entry file for tool definition and metadata</summary>
+
+```typescript
+import { MCPServer } from "mcp-use";
+import { z } from "zod";
+
+const server = new MCPServer({
+  name: "weather-app",
+  title: "Weather App",
+  version: "1.0.0",
+});
+
+const weatherInput = z.object({
+  city: z.string().describe("City to look up"),
+});
+
+const weatherOutput = z.object({
+  city: z.string(),
+  temperature: z.number(),
+  conditions: z.string(),
+});
+
+export const getWeather = server.tool(
+  {
+    name: "get-weather",
+    title: "Get weather",
+    description: "Get the current weather for a city",
+    inputSchema: weatherInput,
+    outputSchema: weatherOutput,
+    view: { name: "weather-card" },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true,
+    },
+  },
+  async ({ city }) => {
+    const weather = {
+      city,
+      temperature: 22,
+      conditions: "Sunny",
+    };
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Weather in ${city}: ${weather.conditions}, ${weather.temperature}°C`,
+        },
+      ],
+      structuredContent: weather,
+    };
+  },
+);
+
+export default server;
+```
+
+</details>
+</td></tr></table>
+
+[Explore MCP server tools →](https://mcp-use.com/docs/typescript/server/tools)
+
+## Add Views to your tools
+
+Create `views/weather-card/view.tsx`. The directory name matches `view.name` on the tool:
+
+<table><tr><td>
+<details>
+<summary><strong><code>view.tsx</code></strong> — Return a view from your tools: React weather card</summary>
+
+```tsx
+import { useCallTool, useToolContext } from "mcp-use/react";
+
+export default function WeatherCard() {
+  const { status, toolOutput, toolInput } =
+    useToolContext<"get-weather">();
+  const refresh = useCallTool("get-weather");
+
+  if (status === "pending") {
+    return <p>Checking the weather in {toolInput?.city ?? "your city"}…</p>;
+  }
+  if (status === "error") return <p>Could not load the weather.</p>;
+
+  const weather = refresh.data?.structuredContent ?? toolOutput;
+
+  return (
+    <main style={{ padding: 24 }}>
+      <h2>{weather.city}</h2>
+      <p>
+        {weather.temperature}°C · {weather.conditions}
+      </p>
+      <button
+        disabled={refresh.isPending}
+        onClick={() => void refresh.callTool({ city: weather.city })}
+      >
+        {refresh.isPending ? "Refreshing…" : "Refresh"}
+      </button>
+      {refresh.error && <p>{refresh.error.message}</p>}
+    </main>
+  );
+}
+```
+
+</details>
+</td></tr></table>
+
+<p align="center">
+  <img src="./static/readme/chatgpt-hello-world.jpg" alt="Hello World MCP App rendered in a ChatGPT conversation" width="100%" />
+  <br />
+  <sub>Build interactive UI experiences within ChatGPT with mcp-use.</sub>
+</p>
+
+[Build your first MCP App →](https://mcp-use.com/docs/typescript/mcp-apps/quickstart)
+
+## Build
+
+Create the production build:
+
+```bash
+npm run build
+```
+
+## Inspect
+
+Start development mode to serve the MCP endpoint at [`http://localhost:3000/mcp`](http://localhost:3000/mcp). The Inspector is automatically available at [`http://localhost:3000/mcp/inspector`](http://localhost:3000/mcp/inspector):
+
+```bash
+npm run dev
+```
+
+<p align="center">
+  <img src="./static/readme/inspector-hello-world.jpg" alt="Hello World MCP App rendered in the mcp-use Inspector" width="100%" />
+  <br />
+  <sub>Invoke tools, validate inputs, and inspect interactive Views in the same development loop.</sub>
+</p>
+
+Start a tunnel from the Inspector UI or run `mcp-use dev --tunnel` to get a public URL for your local MCP server and test it with ChatGPT and Claude before deployment. [Learn more about tunneling →](https://docs.mcp-use.com/tunneling)
+
+Inspect the same server headlessly from the terminal, invoke representative tools, and capture a View screenshot:
+
+```bash
+npm install --save-dev @mcp-use/client
+npx mcp-use client connect local http://localhost:3000/mcp
+npx mcp-use client local tools list
+npx mcp-use client local tools call get-weather city=Tokyo
+npx mcp-use screenshot \
+  --server local \
+  --tool get-weather \
+  city=Tokyo \
+  --output weather-card.png
+```
+
+## Deploy
+
+Ship to [Manufact](https://manufact.com) and get observability, analytics, evals, submission readiness, and Git-based preview environments for free.
+
+```bash
+npm run deploy
+```
+
+Prefer to run it yourself? Follow the [self-hosting guide →](https://mcpuse-codex-v1-v2-docs-split.mintlify.site/v2/typescript/server/deployment/runtime-patterns).
+
+## How mcp-use compares
+
+mcp-use builds on the official TypeScript SDK v2 and adds first-class Views, typed tool-to-UI contracts, an optimized stateless runtime, the Inspector, screenshot verification, agent-first CLI workflows, and deployment.
+
+```mermaid
+block-beta
+  columns 7
+
+  metric["Metric"] mcp["mcp-use v2"] fastmcp["FastMCP TS"] official["Official SDK v2*"] xmcp["xmcp"] skybridge["Skybridge"] handler["mcp-handler"]
+
+  speed["Speed"] speedMcp["10,982 ops/s"] speedFast["6,628 ops/s"] speedOfficial["8,050 ops/s"] speedXmcp["6,585 ops/s"] speedSkybridge["8,116 ops/s"] speedHandler["6,324 ops/s"]
+  install["MCP App<br/>dev stack"] installMcp["74.4 MiB"] installFast["122.5 MiB"] installOfficial["99.0 MiB"] installXmcp["121.9 MiB"] installSkybridge["137.5 MiB"] installHandler["388.0 MiB"]
+  packages["Installed<br/>packages"] packagesMcp["51"] packagesFast["180"] packagesOfficial["119"] packagesXmcp["171"] packagesSkybridge["300"] packagesHandler["130"]
+  views["Views"] viewsMcp["✅"] viewsFast["✅"] viewsOfficial["◐ Extension"] viewsXmcp["✅"] viewsSkybridge["✅"] viewsHandler["❌"]
+  nativeViews["Native Views<br/>on MCP 2026"] nativeViewsMcp["✅"] nativeViewsFast["✅"] nativeViewsOfficial["❌"] nativeViewsXmcp["❌"] nativeViewsSkybridge["❌"] nativeViewsHandler["❌"]
+  oauth["One-line<br/>OAuth adapters"] oauthMcp["✅"] oauthFast["◐ Provider/proxy"] oauthOfficial["◐ Primitives"] oauthXmcp["✅"] oauthSkybridge["✅"] oauthHandler["❌"]
+  protocol["MCP 2026<br/>protocol"] protocolMcp["✅"] protocolFast["✅"] protocolOfficial["✅"] protocolXmcp["❌"] protocolSkybridge["❌"] protocolHandler["❌"]
+  screenshot["Built-in View<br/>screenshot CLI"] screenshotMcp["✅"] screenshotFast["❌"] screenshotOfficial["❌"] screenshotXmcp["❌"] screenshotSkybridge["❌"] screenshotHandler["❌"]
+  tunnel["Built-in<br/>tunneling"] tunnelMcp["✅"] tunnelFast["❌"] tunnelOfficial["❌"] tunnelXmcp["❌"] tunnelSkybridge["✅"] tunnelHandler["❌"]
+  inspector["Built-in<br/>Inspector"] inspectorMcp["✅"] inspectorFast["✅"] inspectorOfficial["❌"] inspectorXmcp["❌"] inspectorSkybridge["◐ Limited"] inspectorHandler["❌"]
+
+  classDef metricLabel fill:#6e76811a,font-weight:bold
+  classDef brand fill:#2ea04333,stroke:#2da44e,stroke-width:3px,font-weight:bold
+  classDef header fill:#6e76811a,font-weight:bold
+  classDef value fill:#6e76810f,stroke-width:1px
+  classDef leader fill:#2ea0432e,stroke:#2da44e,stroke-width:2px,font-weight:bold
+  classDef partial fill:#bb80092e,stroke:#bf8700,stroke-width:2px,font-weight:bold
+  classDef unavailable fill:#6e76810f,opacity:0.72
+
+  class metric,speed,install,packages,views,nativeViews,oauth,protocol,screenshot,tunnel,inspector metricLabel
+  class mcp brand
+  class fastmcp,official,xmcp,skybridge,handler header
+  class speedFast,speedOfficial,speedXmcp,speedSkybridge,speedHandler,installFast,installOfficial,installXmcp,installSkybridge,installHandler,packagesFast,packagesOfficial,packagesXmcp,packagesSkybridge,packagesHandler value
+  class speedMcp,installMcp,packagesMcp,viewsMcp,viewsFast,viewsXmcp,viewsSkybridge,nativeViewsMcp,nativeViewsFast,oauthMcp,oauthXmcp,oauthSkybridge,protocolMcp,protocolFast,protocolOfficial,screenshotMcp,tunnelMcp,tunnelSkybridge,inspectorMcp,inspectorFast leader
+  class oauthFast,viewsOfficial,oauthOfficial,inspectorSkybridge partial
+  class viewsHandler,nativeViewsOfficial,nativeViewsXmcp,nativeViewsSkybridge,nativeViewsHandler,oauthHandler,protocolXmcp,protocolSkybridge,protocolHandler,screenshotFast,screenshotOfficial,screenshotXmcp,screenshotSkybridge,screenshotHandler,tunnelFast,tunnelOfficial,tunnelXmcp,tunnelHandler,inspectorOfficial,inspectorXmcp,inspectorHandler unavailable
+```
+
+<sub>* Includes `@modelcontextprotocol/ext-apps`, Vite, and zod for an MCP Apps-capable stack.</sub>
+
+<sub>Install rows compare custom React MCP App development stacks. FastMCP therefore includes the Apps extension, React, Vite React plugin, Vite, TypeScript, and zod rather than only its narrower server-side component workflow. Size is actual `node_modules` disk usage after a normal npm install, including required peer dependencies.</sub>
+
+**[Read the detailed benchmark report →](./benchmark.md)**
+
+## Examples
+
+Remix a complete MCP App, inspect the source, or deploy it as a starting point:
+
+| Preview | App | What it demonstrates |
+| --- | --- | --- |
+| <img src="https://raw.githubusercontent.com/mcp-use/mcp-chart-builder/main/repo-assets/demo.gif" alt="Chart Builder demo" width="280"> | [Chart Builder](https://github.com/mcp-use/mcp-chart-builder) | Structured data rendered as interactive charts · [Open demo](https://yellow-shadow-21833.run.mcp-use.com/mcp) |
+| <img src="https://raw.githubusercontent.com/mcp-use/mcp-diagram-builder/main/repo-assets/demo.gif" alt="Diagram Builder demo" width="280"> | [Diagram Builder](https://github.com/mcp-use/mcp-diagram-builder) | Create and edit diagrams through MCP tools · [Open demo](https://lucky-darkness-402ph.run.mcp-use.com/mcp) |
+| <img src="https://raw.githubusercontent.com/mcp-use/mcp-maps-explorer/main/repo-assets/demo.gif" alt="Maps Explorer demo" width="280"> | [Maps Explorer](https://github.com/mcp-use/mcp-maps-explorer) | Search, detail tools, and an interactive map view · [Open demo](https://super-night-ttde2.run.mcp-use.com/mcp) |
+
+[Browse all TypeScript examples →](./libraries/typescript/packages/server/examples)
+
+## Ecosystem
+
+| Package | Use it for |
+| --- | --- |
+| [`mcp-use`](https://www.npmjs.com/package/mcp-use) | TypeScript v2 server framework, React views, and CLI |
+| [`@mcp-use/client`](https://www.npmjs.com/package/@mcp-use/client) | Connect to MCP servers from Node.js, browsers, React, and sandboxes |
+| [`@mcp-use/agent`](https://www.npmjs.com/package/@mcp-use/agent) | Build model-powered agents on top of MCP clients |
+| [`@mcp-use/inspector`](https://www.npmjs.com/package/@mcp-use/inspector) | Inspect and debug MCP servers and apps |
+| [`create-mcp-use-app`](https://www.npmjs.com/package/create-mcp-use-app) | Scaffold servers and interactive apps |
+| [`mcp-use` for Python](https://pypi.org/project/mcp-use/) | Build Python MCP servers, clients, and agents |
+
+- [TypeScript documentation](https://mcp-use.com/docs/typescript)
+- [Python documentation](https://mcp-use.com/docs/python)
+- [Inspector documentation](https://mcp-use.com/docs/inspector/index)
+- [Agent documentation](https://mcp-use.com/docs/typescript/agent/index)
+- [Client documentation](https://mcp-use.com/docs/typescript/client/index)
+
+## Protocol conformance
+
+<div align="center">
+  <a href="https://github.com/mcp-use/mcp-use/actions/workflows/conformance.yml">
+    <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/tonxxd/6edf670f0446dc9f7a1f32d6bfda2b70/raw/python-conformance.json" alt="Python MCP conformance">
+  </a>
+  <a href="https://github.com/mcp-use/mcp-use/actions/workflows/conformance.yml">
+    <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/tonxxd/6edf670f0446dc9f7a1f32d6bfda2b70/raw/python-client-conformance.json" alt="Python MCP client conformance">
+  </a>
+  <a href="https://github.com/mcp-use/mcp-use/actions/workflows/conformance.yml">
+    <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/tonxxd/6edf670f0446dc9f7a1f32d6bfda2b70/raw/typescript-conformance.json" alt="TypeScript MCP conformance">
+  </a>
+  <a href="https://github.com/mcp-use/mcp-use/actions/workflows/conformance.yml">
+    <img src="https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/tonxxd/6edf670f0446dc9f7a1f32d6bfda2b70/raw/typescript-node-client-conformance.json" alt="TypeScript MCP client conformance">
+  </a>
+</div>
+
+## Security and community
+
+- [Security policy](./SECURITY.md)
+- [Contribution guide](./CONTRIBUTING.md)
+- [GitHub issues](https://github.com/mcp-use/mcp-use/issues)
+- [Discord community](https://discord.gg/XkNkSkMz3V)
+- [Manufact](https://manufact.com)
+- [MIT license](./LICENSE)
+
+## Contributors
+
+Built by [Pietro](https://github.com/pietrozullo), [Luigi](https://github.com/pederzh), [Enrico](https://github.com/tonxxd), and the mcp-use community.
+
+<a href="https://github.com/mcp-use/mcp-use/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=mcp-use/mcp-use" alt="mcp-use contributors">
+</a>

package/dist/bin.js

@@ -1,180 +1,2 @@
 #!/usr/bin/env node
-import {
-  parseArgs
-} from "./chunk-IG2BCCMU.js";
-
-// src/bin/main.ts
-import { readFileSync } from "fs";
-var HELP = `mcp-use \u2014 run MCP servers built with mcp-use
-
-Usage: mcp-use <command> [options]
-
-Commands:
-  dev      Start the dev server
-  build    Build the server into .mcp-use/build
-  start    Serve the production build from .mcp-use/build
-  login    Authenticate the cloud CLI
-  logout   Delete local cloud credentials
-  whoami   Show the authenticated cloud identity
-  org      Manage the active organization
-  servers  Manage cloud servers and environment variables
-  deployments Manage cloud deployments and logs
-  deploy   Deploy the current GitHub project
-  client   Connect to and invoke MCP servers
-  skills   Install maintained coding-agent skills
-  screenshot Capture an MCP Apps view
-
-Options:
-  -p, --port <n>     Port to serve on (default: $PORT or 3000)
-  --host <host>      Host to bind (dev only)
-  --entry <path>     Server entry module (dev/build only)
-  --with-inspector   Record inspector availability in the build manifest (build only)
-  --tunnel           Expose the dev server through a public tunnel (dev only)
-  --no-open          Do not auto-open the inspector in a browser (dev only)
-  -h, --help         Show this help
-  -v, --version      Print the version`;
-async function main(argv) {
-  if (argv.length === 1 && ["--version", "-v"].includes(argv[0] ?? "")) {
-    console.log(readOwnVersion());
-    return 0;
-  }
-  if (argv.some((token) => token === "--help" || token === "-h")) {
-    console.log(HELP);
-    return 0;
-  }
-  const command = argv[0];
-  if (command === "login" || command === "logout" || command === "whoami") {
-    const { runIdentity } = await import("./commands/identity.js");
-    return runIdentity(command, argv.slice(1));
-  }
-  if (command === "org") {
-    const { runOrganizations } = await import("./commands/organizations.js");
-    return runOrganizations(argv.slice(1));
-  }
-  if (command === "servers") {
-    const { runServers } = await import("./commands/servers.js");
-    return runServers(argv.slice(1));
-  }
-  if (command === "deployments") {
-    const { runDeployments } = await import("./commands/deployments.js");
-    return runDeployments(argv.slice(1));
-  }
-  if (command === "deploy") {
-    const { runDeploy } = await import("./commands/deploy.js");
-    return runDeploy(argv.slice(1));
-  }
-  if (command === "client") {
-    const { runClient } = await import("./commands/client.js");
-    return runClient(argv.slice(1));
-  }
-  if (command === "skills") {
-    const { runSkills } = await import("./commands/skills.js");
-    return runSkills(argv.slice(1));
-  }
-  if (command === "screenshot") {
-    const { runScreenshot } = await import("./commands/screenshot.js");
-    return runScreenshot(argv.slice(1));
-  }
-  let args;
-  try {
-    args = parseArgs(argv);
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    return 2;
-  }
-  if (args.version) {
-    console.log(readOwnVersion());
-    return 0;
-  }
-  if (args.help) {
-    console.log(HELP);
-    return 0;
-  }
-  switch (args.command) {
-    case "start":
-      return startCommand(args);
-    case "dev":
-    case "build":
-      return cliCommand(args.command, args);
-    case void 0:
-      console.error(HELP);
-      return 2;
-    default:
-      console.error(`Unknown command: ${args.command}
-
-${HELP}`);
-      return 2;
-  }
-}
-async function startCommand(args) {
-  let started;
-  try {
-    const { runStart } = await import("./commands/start.js");
-    started = await runStart({ cwd: process.cwd(), port: args.port });
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    return 1;
-  }
-  console.log(`mcp-use server running at ${started.url}`);
-  const shutdown = () => {
-    started.close().then(
-      () => process.exit(0),
-      (error) => {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(1);
-      }
-    );
-  };
-  process.once("SIGINT", shutdown);
-  process.once("SIGTERM", shutdown);
-  return 0;
-}
-async function cliCommand(command, args) {
-  const options = {
-    cwd: process.cwd(),
-    ...args.entry !== void 0 && { entry: args.entry },
-    ...args.port !== void 0 && { port: args.port },
-    ...args.host !== void 0 && { host: args.host },
-    ...args.tunnel && { tunnel: true },
-    ...!args.open && { open: false },
-    ...args.withInspector && { withInspector: true }
-  };
-  try {
-    if (command === "dev") {
-      const { runDev } = await import("./commands/dev.js");
-      await runDev(options);
-    } else {
-      const { runBuild } = await import("./commands/build.js");
-      await runBuild(options);
-    }
-    return 0;
-  } catch (error) {
-    console.error(error instanceof Error ? error.message : String(error));
-    return 1;
-  }
-}
-function readOwnVersion() {
-  for (const relative of ["../package.json", "../../package.json"]) {
-    try {
-      const raw = readFileSync(new URL(relative, import.meta.url), "utf8");
-      const pkg = JSON.parse(raw);
-      if ((pkg.name === "mcp-use" || pkg.name === "mcp-use") && typeof pkg.version === "string") {
-        return pkg.version;
-      }
-    } catch {
-    }
-  }
-  return "unknown";
-}
-
-// src/bin.ts
-main(process.argv.slice(2)).then(
-  (code) => {
-    process.exitCode = code;
-  },
-  (error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exitCode = 1;
-  }
-);
-//# sourceMappingURL=bin.js.map
+var{main}=await import("@mcp-use/cli");main(process.argv.slice(2),{frameworkVersion:"2.0.1"}).then(code=>{process.exitCode=code},error=>{console.error(error instanceof Error?error.message:String(error)),process.exitCode=1});

package/dist/branding.d.ts

@@ -4,23 +4,21 @@ import type { FetchHandler } from "./fetch-app.js";
 export interface ServerBranding {
     /**
      * Source selected for `/favicon.ico`, after applying explicit-favicon and
-     * icon-ranking precedence.
+     * first-icon inference.
      */
     readonly favicon?: string;
+    /** MIME type of the selected favicon when known. */
+    readonly faviconMimeType?: string;
     /** Icons reported in MCP implementation metadata, in author order. */
     readonly icons?: readonly Icon[];
     /** Server website reported in MCP implementation metadata. */
     readonly websiteUrl?: string;
 }
-interface NormalizedServerBranding extends ServerBranding {
-    readonly faviconMimeType?: string;
-}
 /**
  * Select the browser favicon from an ordered set of MCP icons.
  *
- * Ranking is deterministic: ICO, 16x16/32x32 PNG, any PNG, then the first
- * icon. MIME declarations and URL pathnames participate alongside filename
- * suffixes, so absolute URLs with queries and data URLs rank correctly.
+ * Uses the first icon in author order. Put the preferred browser favicon
+ * first, or set {@link ServerConfig.favicon} explicitly.
  *
  * @param icons - Validated, non-empty icon list.
  * @returns The selected icon.
@@ -40,7 +38,7 @@ export declare function normalizeServerBranding(config: {
     favicon?: unknown;
     icons?: unknown;
     websiteUrl?: unknown;
-}): NormalizedServerBranding;
+}): ServerBranding;
 /**
  * Resolve configured icons for MCP implementation metadata.
  *
@@ -76,10 +74,8 @@ export declare function hasLocalBrandingAsset(branding: ServerBranding): boolean
  *
  * @internal
  */
-export declare function createFaviconHandler(branding: NormalizedServerBranding, options: {
+export declare function createFaviconHandler(branding: ServerBranding, options: {
     dev: boolean;
     projectRoot: string;
     deferCors?: boolean;
 }): FetchHandler | undefined;
-export {};
-//# sourceMappingURL=branding.d.ts.map

package/dist/buffered-response.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Mark a framework-owned response whose body is already buffered in memory.
+ *
+ * @internal
+ */
+export declare function markBufferedResponse(response: Response): Response;
+/**
+ * Associate a known-buffered SDK response with the request that produced it.
+ *
+ * Keeping the source response lets the Node bridge recognize framework-owned
+ * header wrappers by body identity without trusting a content type. If any
+ * middleware clones or replaces the body, the identity check fails closed.
+ *
+ * @internal
+ */
+export declare function trackBufferedResponse(request: Request, response: Response): Response;
+/** Whether a response body is covered by the framework's buffered contract. */
+export declare function isBufferedResponse(response: Response, request?: Request): boolean;
+/**
+ * Preserve the marker across a framework-owned, header-only response wrapper.
+ *
+ * Body-transforming user middleware does not call this helper, so replacing a
+ * response still drops the buffered contract automatically.
+ *
+ * @internal
+ */
+export declare function inheritBufferedResponse(source: Response, target: Response): Response;