mcp-use 2.0.0-beta.7 → 2.0.0-beta.9

package/dist/index.d.ts

@@ -42,6 +42,9 @@ export type { CompletionCallback, CompletionContext } from "./completable.js";
  */
 export type { StandardSchemaV1, StandardSchemaWithJSON, } from "@modelcontextprotocol/server";
 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, McpCompleteEventListenerFn, McpEventListenerFn, McpMiddlewareFn, McpMiddlewareFnFor, McpMiddlewarePatternMap, PromptsGetMiddlewareContext, ResourcesReadMiddlewareContext, ToolsCallMiddlewareContext, } from "./middleware/mcp-middleware.js";
 export { composeMiddleware, matchesPattern, } from "./middleware/mcp-middleware.js";
 export type { NodeRequestHandler } from "./node-bridge.js";
@@ -49,6 +52,6 @@ export type { FromOpenAPIOptions, OpenAPIAuth, OpenAPIDocument, OpenAPIExcludeRu
 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";
 //# 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,MAAM,gBAAgB,CAAC;AAChD,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,EACV,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,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;AAC7D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC;;;;;GAKG;AACH,YAAY,EACV,WAAW,EACX,UAAU,EACV,eAAe,GAChB,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,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,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,EACV,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,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;AAC7D,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,YAAY,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC;;;;;GAKG;AACH,YAAY,EACV,WAAW,EACX,UAAU,EACV,eAAe,GAChB,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,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,kEAAkE;AAClE,YAAY,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,cAAc,GACf,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,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,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,14 @@
+import {
+  resolvePublicFilePath,
+  servePublicFile
+} from "./chunk-SMN75YED.js";
 import {
   registerOpenAPITools
 } from "./chunk-AATFAERC.js";
+import {
+  completable,
+  normalizeCompletions
+} from "./chunk-KIZ72TIK.js";
 import {
   synthesizeViewDocument
 } from "./chunk-STCR3P5O.js";
@@ -46,6 +54,266 @@ import {
   isInputRequiredResult
 } from "@modelcontextprotocol/server";
 
+// src/branding.ts
+var FAVICON_CACHE_CONTROL = "public, max-age=31536000, immutable";
+var FAVICON_REDIRECT_CACHE_CONTROL = "public, max-age=300";
+function protocolOf(value) {
+  const match = /^([a-z][a-z\d+.-]*):/i.exec(value);
+  return match?.[1]?.toLowerCase();
+}
+function publicAssetPath(basePath, source) {
+  const prefix = basePath === "/" ? "" : basePath;
+  return `${prefix}/_mcp-use/public/${source.split("/").map((segment) => encodeURIComponent(segment)).join("/")}`;
+}
+function isLocalPublicSource(source) {
+  return protocolOf(source) === void 0;
+}
+function extensionPath(source) {
+  const protocol = protocolOf(source);
+  if (protocol === "data") {
+    return "";
+  }
+  if (protocol === "http" || protocol === "https") {
+    return new URL(source).pathname.toLowerCase();
+  }
+  return source.toLowerCase();
+}
+function dataUrlMimeType(source) {
+  if (protocolOf(source) !== "data") {
+    return void 0;
+  }
+  const comma = source.indexOf(",");
+  if (comma < 0) {
+    return void 0;
+  }
+  const mimeType = source.slice(5, comma).split(";", 1)[0]?.toLowerCase();
+  return mimeType === "" ? void 0 : mimeType;
+}
+function iconMimeType(icon) {
+  return icon.mimeType?.toLowerCase() ?? dataUrlMimeType(icon.src);
+}
+function isIco(icon) {
+  const mimeType = iconMimeType(icon);
+  return mimeType === "image/x-icon" || mimeType === "image/vnd.microsoft.icon" || extensionPath(icon.src).endsWith(".ico");
+}
+function isPng(icon) {
+  return iconMimeType(icon) === "image/png" || extensionPath(icon.src).endsWith(".png");
+}
+function selectFaviconFromIcons(icons) {
+  return icons.find(isIco) ?? icons.find(
+    (icon) => isPng(icon) && icon.sizes?.some((size) => size === "16x16" || size === "32x32")
+  ) ?? icons.find(isPng) ?? icons[0];
+}
+function assertLocalPublicSource(source, field) {
+  if (source.startsWith("/") || source.includes("\\") || source.includes("?") || source.includes("#") || source.split("/").some((segment) => segment === "" || segment === "..")) {
+    throw new TypeError(
+      `${field} must be an http(s) URL, image data URL, or safe path relative to public/`
+    );
+  }
+}
+function parseDataImage(source, field) {
+  const comma = source.indexOf(",");
+  if (comma < 0) {
+    throw new TypeError(`${field} must be a valid image data URL`);
+  }
+  const metadata = source.slice(5, comma);
+  const payload = source.slice(comma + 1);
+  const parts = metadata.split(";");
+  const mimeType = parts[0]?.toLowerCase() ?? "";
+  if (!mimeType.startsWith("image/")) {
+    throw new TypeError(`${field} data URL must use an image MIME type`);
+  }
+  try {
+    if (parts.includes("base64")) {
+      const binary = atob(payload);
+      return {
+        mimeType,
+        bytes: Uint8Array.from(binary, (character) => character.charCodeAt(0))
+      };
+    }
+    return {
+      mimeType,
+      bytes: new TextEncoder().encode(decodeURIComponent(payload))
+    };
+  } catch {
+    throw new TypeError(`${field} must be a valid image data URL`);
+  }
+}
+function assertBrandingSource(source, field) {
+  if (typeof source !== "string" || source.length === 0) {
+    throw new TypeError(`${field} must be a non-empty string`);
+  }
+  const protocol = protocolOf(source);
+  if (protocol === void 0) {
+    assertLocalPublicSource(source, field);
+    return source;
+  }
+  if (protocol === "data") {
+    parseDataImage(source, field);
+    return source;
+  }
+  if (protocol !== "http" && protocol !== "https") {
+    throw new TypeError(
+      `${field} must be an http(s) URL, image data URL, or safe path relative to public/`
+    );
+  }
+  try {
+    new URL(source);
+  } catch {
+    throw new TypeError(`${field} must be a valid absolute http(s) URL`);
+  }
+  return source;
+}
+function normalizeServerBranding(config) {
+  let websiteUrl;
+  if (config.websiteUrl !== void 0) {
+    if (typeof config.websiteUrl !== "string" || config.websiteUrl.length === 0) {
+      throw new TypeError(
+        "websiteUrl must be a non-empty absolute http(s) URL"
+      );
+    }
+    let parsed;
+    try {
+      parsed = new URL(config.websiteUrl);
+    } catch {
+      throw new TypeError(
+        "websiteUrl must be a non-empty absolute http(s) URL"
+      );
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+      throw new TypeError(
+        "websiteUrl must be a non-empty absolute http(s) URL"
+      );
+    }
+    websiteUrl = config.websiteUrl;
+  }
+  let icons;
+  if (config.icons !== void 0) {
+    if (!Array.isArray(config.icons)) {
+      throw new TypeError("icons must be an array of MCP Icon objects");
+    }
+    icons = Object.freeze(
+      config.icons.map((value, index) => {
+        if (typeof value !== "object" || value === null) {
+          throw new TypeError(`icons[${index}] must be an MCP Icon object`);
+        }
+        const icon = value;
+        const src = assertBrandingSource(icon["src"], `icons[${index}].src`);
+        const mimeType = icon["mimeType"];
+        if (mimeType !== void 0 && (typeof mimeType !== "string" || !mimeType.toLowerCase().startsWith("image/"))) {
+          throw new TypeError(
+            `icons[${index}].mimeType must be an image MIME type when provided`
+          );
+        }
+        const sizes = icon["sizes"];
+        if (sizes !== void 0 && (!Array.isArray(sizes) || sizes.some((size) => typeof size !== "string" || size.length === 0))) {
+          throw new TypeError(
+            `icons[${index}].sizes must be an array of non-empty strings when provided`
+          );
+        }
+        const normalizedSizes = sizes === void 0 ? void 0 : sizes.map((size) => size);
+        const theme = icon["theme"];
+        if (theme !== void 0 && theme !== "light" && theme !== "dark") {
+          throw new TypeError(
+            `icons[${index}].theme must be "light" or "dark" when provided`
+          );
+        }
+        return Object.freeze({
+          src,
+          ...mimeType !== void 0 && { mimeType },
+          ...normalizedSizes !== void 0 && {
+            sizes: Object.freeze(normalizedSizes)
+          },
+          ...theme !== void 0 && { theme }
+        });
+      })
+    );
+  }
+  const explicitFavicon = config.favicon === void 0 ? void 0 : assertBrandingSource(config.favicon, "favicon");
+  const inferred = explicitFavicon === void 0 ? selectFaviconFromIcons(icons ?? []) : void 0;
+  const favicon = explicitFavicon ?? inferred?.src;
+  const faviconMimeType = inferred?.mimeType ?? icons?.find((icon) => icon.src === explicitFavicon)?.mimeType;
+  return Object.freeze({
+    ...favicon !== void 0 && { favicon },
+    ...faviconMimeType !== void 0 && { faviconMimeType },
+    ...icons !== void 0 && { icons },
+    ...websiteUrl !== void 0 && { websiteUrl }
+  });
+}
+function resolveImplementationIcons(icons, request, basePath) {
+  if (icons === void 0) {
+    return void 0;
+  }
+  return icons.map((icon) => ({
+    ...icon,
+    src: request !== void 0 && isLocalPublicSource(icon.src) ? `${resolveAssetsBase(request)}${publicAssetPath(basePath, icon.src)}` : icon.src,
+    ...icon.sizes !== void 0 && { sizes: [...icon.sizes] }
+  }));
+}
+function hasLocalBrandingAsset(branding) {
+  return branding.favicon !== void 0 && isLocalPublicSource(branding.favicon) || branding.icons?.some((icon) => isLocalPublicSource(icon.src)) === true;
+}
+function createFaviconHandler(branding, options) {
+  const source = branding.favicon;
+  if (source === void 0) {
+    return void 0;
+  }
+  return async (request) => {
+    if (request.method !== "GET" && request.method !== "HEAD") {
+      return new Response("Method Not Allowed", {
+        status: 405,
+        headers: { Allow: "GET, HEAD" }
+      });
+    }
+    if (new URL(request.url).pathname !== "/favicon.ico") {
+      return new Response("Not Found", { status: 404 });
+    }
+    const protocol = protocolOf(source);
+    if (protocol === "http" || protocol === "https") {
+      return new Response(null, {
+        status: 307,
+        headers: {
+          Location: source,
+          "Cache-Control": FAVICON_REDIRECT_CACHE_CONTROL
+        }
+      });
+    }
+    if (protocol === "data") {
+      const data = parseDataImage(source, "favicon");
+      return new Response(
+        request.method === "HEAD" ? null : data.bytes.buffer,
+        {
+          status: 200,
+          headers: {
+            "Content-Type": branding.faviconMimeType ?? data.mimeType,
+            "Cache-Control": FAVICON_CACHE_CONTROL,
+            "X-Content-Type-Options": "nosniff"
+          }
+        }
+      );
+    }
+    const { join } = await import("path");
+    const publicRoot = options.dev ? join(options.projectRoot, "public") : join(options.projectRoot, ".mcp-use/build/views/public");
+    const diskPath = await resolvePublicFilePath(publicRoot, source);
+    if (diskPath === null) {
+      return new Response("Not Found", {
+        status: 404,
+        headers: { "Cache-Control": "no-store" }
+      });
+    }
+    const response = await servePublicFile(diskPath, {
+      ...options.deferCors === true && { deferCors: true },
+      ...request.method === "HEAD" && { head: true }
+    });
+    response.headers.set("Cache-Control", FAVICON_CACHE_CONTROL);
+    response.headers.set("X-Content-Type-Options", "nosniff");
+    if (branding.faviconMimeType !== void 0) {
+      response.headers.set("Content-Type", branding.faviconMimeType);
+    }
+    return response;
+  };
+}
+
 // src/config.ts
 function assertServerConfig(config) {
   if (config.basePath !== void 0) {
@@ -435,7 +703,7 @@ function serializeForInlineScript(value) {
   return JSON.stringify(value).replaceAll("<", "\\u003c");
 }
 function renderInspectorShell(options) {
-  const { serverName, basePath, assetsUrl, manufactChatUrl } = options;
+  const { serverName, basePath, faviconHref, assetsUrl, manufactChatUrl } = options;
   const serializedBasePath = serializeForInlineScript(basePath);
   const serializedManufactChatUrl = manufactChatUrl ? serializeForInlineScript(manufactChatUrl) : null;
   const rawUrl = assetsUrl ?? DEFAULT_INSPECTOR_ASSETS_URL;
@@ -448,6 +716,7 @@ function renderInspectorShell(options) {
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>${escapeHtml(serverName)} \u2014 MCP Inspector</title>
+    ${faviconHref !== void 0 ? `<link rel="icon" href="${escapeHtml(faviconHref)}" />` : ""}
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
@@ -508,6 +777,9 @@ function createInspectorHandler(inspector, options) {
   const shellOptions = {
     serverName: options.serverName,
     basePath: options.basePath,
+    ...options.faviconHref !== void 0 && {
+      faviconHref: options.faviconHref
+    },
     assetsUrl,
     manufactChatUrl
   };
@@ -1043,20 +1315,20 @@ function createViewAssetsHandler(basePath, views, options) {
     if (entry === void 0 || entry.kind !== "external") {
       return new Response("Not Found", { status: 404 });
     }
-    const [{ join }, { resolvePublicFilePath, servePublicFile }] = await Promise.all([import("path"), import("./public-route-26FUVRO5.js")]);
+    const [{ join }, { resolvePublicFilePath: resolvePublicFilePath2, servePublicFile: servePublicFile2 }] = await Promise.all([import("path"), import("./public-route-5JEGFEIN.js")]);
     const viewRoot = join(projectRoot, VIEW_ASSETS_BUILD_ROOT, viewName);
-    const diskPath = await resolvePublicFilePath(viewRoot, subpath);
+    const diskPath = await resolvePublicFilePath2(viewRoot, subpath);
     if (diskPath === null) {
       return new Response("Not Found", { status: 404 });
     }
-    return await servePublicFile(
-      diskPath,
-      options?.deferCors === true ? { deferCors: true } : {}
-    );
+    return await servePublicFile2(diskPath, {
+      ...options?.deferCors === true && { deferCors: true },
+      ...request.method === "HEAD" && { head: true }
+    });
   };
 }
 function createViewPublicHandler(basePath, views, options) {
-  if (views.size === 0) {
+  if (views.size === 0 && options?.enabled !== true) {
     return void 0;
   }
   const publicPrefix = pathUnderBase(basePath, "_mcp-use/public");
@@ -1070,20 +1342,26 @@ function createViewPublicHandler(basePath, views, options) {
       return new Response("Not Found", { status: 404 });
     }
     const pathname = pathnameOf(request);
-    const subpath = pathname.slice(publicPrefix.length + 1);
+    const encodedSubpath = pathname.slice(publicPrefix.length + 1);
+    let subpath;
+    try {
+      subpath = decodeURIComponent(encodedSubpath);
+    } catch {
+      return new Response("Not Found", { status: 404 });
+    }
     if (subpath.length === 0) {
       return new Response("Not Found", { status: 404 });
     }
-    const [{ join }, { resolvePublicFilePath, servePublicFile }] = await Promise.all([import("path"), import("./public-route-26FUVRO5.js")]);
+    const [{ join }, { resolvePublicFilePath: resolvePublicFilePath2, servePublicFile: servePublicFile2 }] = await Promise.all([import("path"), import("./public-route-5JEGFEIN.js")]);
     const publicRoot = join(projectRoot, subdir);
-    const diskPath = await resolvePublicFilePath(publicRoot, subpath);
+    const diskPath = await resolvePublicFilePath2(publicRoot, subpath);
     if (diskPath === null) {
       return new Response("Not Found", { status: 404 });
     }
-    return await servePublicFile(
-      diskPath,
-      options?.deferCors === true ? { deferCors: true } : {}
-    );
+    return await servePublicFile2(diskPath, {
+      ...options?.deferCors === true && { deferCors: true },
+      ...request.method === "HEAD" && { head: true }
+    });
   };
 }
 
@@ -1159,6 +1437,7 @@ function viewResourceConfig(_viewName, _entry, authorFacts, options) {
 // src/server.ts
 var MCPServer = class _MCPServer {
   #config;
+  #branding;
   #tools = /* @__PURE__ */ new Map();
   #resources = /* @__PURE__ */ new Map();
   #resourceTemplates = /* @__PURE__ */ new Map();
@@ -1224,6 +1503,7 @@ var MCPServer = class _MCPServer {
   constructor(config) {
     assertServerConfig(config);
     this.#config = config;
+    this.#branding = normalizeServerBranding(config);
     if (config.oauth !== void 0) {
       const mcpUrl = typeof process === "undefined" ? void 0 : process.env["MCP_URL"];
       const resource = resolveConfiguredOAuthResource({
@@ -1246,6 +1526,24 @@ var MCPServer = class _MCPServer {
   get basePath() {
     return this.#basePath();
   }
+  /**
+   * Immutable normalized branding shared by MCP identity and browser pages.
+   *
+   * `favicon` is the final source after explicit-favicon and icon-selection
+   * precedence. Landing-page integrations can use this accessor and link to
+   * the server's root-level `/favicon.ico` route without reading private
+   * configuration or depending on the inspector/view layers.
+   *
+   * @example
+   * ```ts
+   * if (server.branding.favicon) {
+   *   console.log("Browser favicon: /favicon.ico");
+   * }
+   * ```
+   */
+  get branding() {
+    return this.#branding;
+  }
   /**
    * Register a tool. Input is validated against `inputSchema` before the callback
    * runs; results carrying `structuredContent` are type-checked against
@@ -1325,8 +1623,10 @@ var MCPServer = class _MCPServer {
    */
   resourceTemplate(definition, callback) {
     this.#assertNotStarted("resourceTemplate", definition.name);
+    const complete = definition.complete === void 0 ? void 0 : normalizeCompletions(definition.complete);
     this.#resourceTemplates.set(definition.name, {
       definition,
+      ...complete !== void 0 && { complete },
       callback
     });
     return this;
@@ -1714,11 +2014,12 @@ var MCPServer = class _MCPServer {
           return mcpRouteHandler(request);
         }
         const respond = async () => {
-          const { createLandingPageResponse } = await import("./landing-handler-VQRYCQOV.js");
+          const { createLandingPageResponse } = await import("./landing-handler-3VN4BMR2.js");
           return createLandingPageResponse(
             request,
             basePath,
             this.#config,
+            this.#branding,
             this.#tools.values(),
             this.#prompts.values(),
             this.#resources.values()
@@ -1730,9 +2031,22 @@ var MCPServer = class _MCPServer {
         return respond();
       };
       const routes = [];
+      const brandingDevMode = this.#viewsPrimed ? this.#viewsDevMode : process.env["NODE_ENV"] !== "production";
+      const faviconHandler = createFaviconHandler(this.#branding, {
+        dev: brandingDevMode,
+        projectRoot: this.#viewsProjectRoot,
+        deferCors: deferViewCors
+      });
+      if (faviconHandler !== void 0) {
+        routes.push({
+          match: (request) => new URL(request.url).pathname === "/favicon.ico",
+          handler: faviconHandler
+        });
+      }
       const viewHandler = createViewPublicHandler(basePath, this.#views, {
-        dev: this.#viewsDevMode,
+        dev: this.#viewsPrimed ? this.#viewsDevMode : brandingDevMode,
         projectRoot: this.#viewsProjectRoot,
+        enabled: hasLocalBrandingAsset(this.#branding),
         deferCors: deferViewCors
       });
       if (viewHandler !== void 0) {
@@ -1760,7 +2074,8 @@ var MCPServer = class _MCPServer {
       }
       const inspectorHandler = createInspectorHandler(this.#config.inspector, {
         serverName: this.#config.name,
-        basePath
+        basePath,
+        ...faviconHandler !== void 0 && { faviconHref: "/favicon.ico" }
       });
       if (inspectorHandler !== void 0) {
         routes.push({
@@ -1849,7 +2164,17 @@ var MCPServer = class _MCPServer {
         name,
         version,
         ...title !== void 0 && { title },
-        ...description !== void 0 && { description }
+        ...description !== void 0 && { description },
+        ...this.#branding.websiteUrl !== void 0 && {
+          websiteUrl: this.#branding.websiteUrl
+        },
+        ...this.#branding.icons !== void 0 && {
+          icons: resolveImplementationIcons(
+            this.#branding.icons,
+            ctx.requestInfo,
+            this.#basePath()
+          )
+        }
       },
       {
         capabilities: {
@@ -2086,9 +2411,10 @@ var MCPServer = class _MCPServer {
       }
     );
   }
-  #registerResourceTemplate(server, { definition, callback }) {
+  #registerResourceTemplate(server, { definition, callback, complete }) {
     const template = new ResourceTemplate(definition.uriTemplate, {
-      list: void 0
+      list: void 0,
+      ...complete !== void 0 && { complete }
     });
     server.registerResource(
       definition.name,
@@ -2195,24 +2521,6 @@ import {
   inputResponse as inputResponse2,
   isInputRequiredResult as isInputRequiredResult2
 } from "@modelcontextprotocol/server";
-
-// src/completable.ts
-import {
-  completable as sdkCompletable
-} from "@modelcontextprotocol/server";
-function completable(schema, complete) {
-  if (typeof complete === "function") {
-    return sdkCompletable(
-      schema,
-      (value, context) => complete(String(value ?? ""), context)
-    );
-  }
-  const values = complete.map(String);
-  return sdkCompletable(schema, (value) => {
-    const prefix = String(value ?? "").toLowerCase();
-    return values.filter((v) => v.toLowerCase().startsWith(prefix));
-  });
-}
 export {
   MCPServer,
   acceptedContent,