mcp-use 2.0.0-beta.5 → 2.0.0-beta.50

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.0-beta.50"}).then(code=>{process.exitCode=code},error=>{console.error(error instanceof Error?error.message:String(error)),process.exitCode=1});

package/dist/branding.d.ts

@@ -0,0 +1,81 @@
+import type { Icon } from "@modelcontextprotocol/server";
+import type { FetchHandler } from "./fetch-app.js";
+/** Normalized server branding shared by browser and MCP identity surfaces. */
+export interface ServerBranding {
+    /**
+     * Source selected for `/favicon.ico`, after applying explicit-favicon and
+     * 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;
+}
+/**
+ * Select the browser favicon from an ordered set of MCP icons.
+ *
+ * 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.
+ *
+ * @internal
+ */
+export declare function selectFaviconFromIcons(icons: readonly Icon[]): Icon | undefined;
+/**
+ * Validate and freeze the branding fields from server configuration.
+ *
+ * @param config - Untyped-compatible branding input.
+ * @returns Immutable normalized branding and the selected favicon MIME type.
+ *
+ * @internal
+ */
+export declare function normalizeServerBranding(config: {
+    favicon?: unknown;
+    icons?: unknown;
+    websiteUrl?: unknown;
+}): ServerBranding;
+/**
+ * Resolve configured icons for MCP implementation metadata.
+ *
+ * Absolute HTTP(S) and data URLs pass through. Public-relative sources become
+ * request-scoped absolute URLs under `${basePath}/_mcp-use/public/`.
+ *
+ * @param icons - Normalized configured icons.
+ * @param request - HTTP request used to derive the public asset origin.
+ * @param basePath - MCP endpoint base path.
+ * @returns Icons suitable for the official SDK `Implementation` object.
+ *
+ * @internal
+ */
+export declare function resolveImplementationIcons(icons: readonly Icon[] | undefined, request: Request | undefined, basePath: string): Icon[] | undefined;
+/**
+ * Whether any configured branding source needs the local public route.
+ *
+ * @param branding - Normalized branding to inspect.
+ * @returns `true` when the favicon or an MCP icon uses a `public/` path.
+ *
+ * @internal
+ */
+export declare function hasLocalBrandingAsset(branding: ServerBranding): boolean;
+/**
+ * Create the root-level `/favicon.ico` handler for normalized branding.
+ *
+ * Local public files and data URLs are streamed directly. Absolute HTTP(S)
+ * sources receive a temporary redirect, avoiding server-side remote fetches.
+ *
+ * @param branding - Normalized server branding.
+ * @param options - Public directory resolution mode.
+ * @returns A GET/HEAD handler, or `undefined` when no favicon is configured.
+ *
+ * @internal
+ */
+export declare function createFaviconHandler(branding: ServerBranding, options: {
+    dev: boolean;
+    projectRoot: string;
+    deferCors?: boolean;
+}): FetchHandler | undefined;

package/dist/chunk-4TTKTNKI.js

@@ -0,0 +1 @@
+function d(e){return e.replace(/\/+$/,"")}function o(e){if(typeof process>"u")return;let n=process.env[e];return n!==void 0&&n!==""?n:void 0}function c(e){for(let n of e.split(",")){let t=new Map;for(let i of n.split(";")){let[u,...f]=i.trim().split("=");u===void 0||f.length===0||t.set(u.toLowerCase(),f.join("=").replace(/^"|"$/g,""))}let s=t.get("proto"),r=t.get("host");if(s!==void 0&&r!==void 0)return`${s}://${r}`}}function a(e){let n=e.headers.get("forwarded");if(n!==null){let r=c(n);if(r!==void 0)return r}let t=e.headers.get("x-forwarded-proto"),s=e.headers.get("x-forwarded-host");if(t!==null&&s!==null){let r=s.split(",")[0]?.trim(),i=t.split(",")[0]?.trim();if(r!==void 0&&i!==void 0&&r!=="")return`${i}://${r}`}return new URL(e.url).origin}function l(e){let n=o("MCP_URL");if(n!==void 0)try{return new URL(n).origin}catch{}return a(e)}function p(e){try{return new URL(e).origin}catch{return e}}function g(e){return d(e)}function h(e){let n=o("MCP_ASSETS_URL");if(n!==void 0)try{return g(new URL(n).href.replace(/\/$/,""))}catch{}return l(e)}function R(){let e=o("MCP_ASSETS_URL");if(e===void 0)return!1;try{return new URL(e),!0}catch{return!1}}export{l as a,p as b,h as c,R as d};

package/dist/chunk-66C62CLW.js

@@ -0,0 +1,2 @@
+var EVENT="mcp_use_sdk_event",ENDPOINT="https://eu.i.posthog.com/i/v0/e/",TOKEN="phc_lyTtbYwvkdSbrcMQNPiKiiRWrrM1seyKIMjycSvItEI",CONTENT=/(^|_)(arguments?|args|body|command|headers?|location|message|organization|path|query|response|secret|subject|token|uri|url|user_agent)(_|$)/i,RESERVED=new Set("feature action sdk_generation telemetry_schema_version sdk_package sdk_version server_id runtime_id identity_stability distinct_id validation_run_id is_validation".split(" ")),runtimeId=crypto.randomUUID(),once=new Set,pending=new Set,identities=new Map;function hasControl(value){return[...value].some(character=>{let code=character.charCodeAt(0);return code<32||code===127})}function env(name){return typeof process>"u"?void 0:process.env?.[name]}function safeEnv(name){let value=env(name);return value!==void 0&&value.length>0&&value.length<=128&&!hasControl(value)?value:void 0}function disabled(){if(env("MCP_USE_ANONYMIZED_TELEMETRY")==="false")return!0;try{return globalThis.__MCP_USE_ANONYMIZED_TELEMETRY__===!1||typeof localStorage<"u"&&localStorage.getItem("MCP_USE_ANONYMIZED_TELEMETRY")==="false"}catch{return!1}}function clean(properties){return Object.fromEntries(Object.entries(properties).filter(([key,value])=>key.length>128||hasControl(key)||key.startsWith("$")||RESERVED.has(key)||CONTENT.test(key)||value===void 0?!1:typeof value=="string"?value.length<=128&&!hasControl(value):typeof value=="boolean"||typeof value=="number"&&Number.isFinite(value)))}async function identity(serverRoot){let projectId=safeEnv("MCP_USE_TELEMETRY_PROJECT_ID");if(projectId!==void 0)return{id:projectId,stability:"project"};if(serverRoot===void 0||typeof process>"u")return{id:runtimeId,stability:"process"};let existing=identities.get(serverRoot);if(existing!==void 0)return existing;let resolving=(async()=>{try{let fs=await import("fs/promises"),directory=`${serverRoot}/.mcp-use`,file=`${directory}/usage.json`,read=async()=>{try{let value=JSON.parse(await fs.readFile(file,"utf8"));if(typeof value=="object"&&value!==null&&"schemaVersion"in value&&value.schemaVersion===1&&"serverId"in value&&typeof value.serverId=="string"&&/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value.serverId))return value.serverId}catch{}},stored=await read();if(stored!==void 0)return{id:stored,stability:"server"};await fs.mkdir(directory,{recursive:!0,mode:448});let created=crypto.randomUUID();try{return await fs.writeFile(file,`${JSON.stringify({schemaVersion:1,serverId:created})}
+`,{flag:"wx",mode:384}),{id:created,stability:"server"}}catch{let raced=await read();if(raced!==void 0)return{id:raced,stability:"server"}}}catch{}return{id:runtimeId,stability:"process"}})();return identities.set(serverRoot,resolving),resolving}function capture(feature,action,properties,options,resolveIdentity){let validationId=safeEnv("MCP_USE_TELEMETRY_VALIDATION_ID");if(disabled()||env("NODE_ENV")==="test"&&validationId===void 0||pending.size>=16)return;if(options.onceKey!==void 0){if(once.has(options.onceKey))return;once.add(options.onceKey)}let rate=Math.max(0,Math.min(1,options.sampleRate??1));if(validationId===void 0&&Math.random()>=rate)return;let request=(async()=>{try{let resolvedIdentity=await resolveIdentity(),body=JSON.stringify({api_key:TOKEN,event:EVENT,properties:{...clean(properties),feature,action,sdk_generation:"v2",telemetry_schema_version:2,sdk_package:"mcp-use",sdk_version:"2.0.0-beta.50",server_id:resolvedIdentity.id,runtime_id:runtimeId,identity_stability:resolvedIdentity.stability,distinct_id:resolvedIdentity.id,sample_rate:validationId===void 0?rate:1,$process_person_profile:!1,$geoip_disable:!0,...validationId!==void 0&&{is_validation:!0,validation_run_id:validationId}}});await fetch(ENDPOINT,{method:"POST",headers:{"content-type":"application/json"},keepalive:!0,body})}catch{return}})();pending.add(request),request.then(()=>pending.delete(request))}function recordUsage(feature,action,properties={},options={}){capture(feature,action,properties,options,()=>identity(options.serverRoot))}async function flushUsage(){await Promise.all([...pending])}export{recordUsage,flushUsage};