@prefecthq/fastmcp-ts 1.7.0 → 1.7.2

package/dist/cli/index.cjs

@@ -1180,7 +1180,7 @@ var init_version = __esm({
       async run({ args }) {
         if (args.json) setJsonMode(true);
         const data = {
-          fastmcp: "1.7.0",
+          fastmcp: "1.7.2",
           "mcp-sdk": "2.0.0",
           node: process.version,
           platform: `${process.platform} ${process.arch}`
@@ -29421,7 +29421,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@prefecthq/fastmcp-ts",
-      version: "1.7.0",
+      version: "1.7.2",
       description: "\u{1F3CE}\uFE0F  The official FastMCP TypeScript library - build MCP servers and clients, fast \u{1F3CE}\uFE0F",
       type: "module",
       exports: {
@@ -30371,6 +30371,20 @@ function buildHttpOptions(auth2, extraHeaders = {}) {
     eventSourceInit: { headers: staticHeaders }
   };
 }
+function parseHttpUrl(input) {
+  if (!URL.canParse(input)) {
+    throw new Error(
+      `"${input}" is not a valid URL. URL strings must be http: or https:. ${STDIO_HINT}`
+    );
+  }
+  const url2 = new URL(input);
+  if (url2.protocol !== "http:" && url2.protocol !== "https:") {
+    throw new Error(
+      `"${input}" has unsupported scheme "${url2.protocol}". URL strings must be http: or https:. ${STDIO_HINT}`
+    );
+  }
+  return url2;
+}
 function urlToTransport(url2, auth2, extraHeaders = {}, legacySSE = false) {
   const { requestInit, fetch: customFetch, eventSourceInit, authProvider } = buildHttpOptions(auth2, extraHeaders);
   const segments = url2.pathname.split("/");
@@ -30412,6 +30426,11 @@ function modernFetchTransport(entry) {
   });
 }
 async function resolveEntryTransport(entry, auth2, options) {
+  if (typeof entry !== "object" || entry === null) {
+    throw new Error(
+      `mcpServers entry ${JSON.stringify(entry)} must be an object with a "url" or "command" key. ${STDIO_HINT}`
+    );
+  }
   if (isMcpServerLike(entry)) {
     if (isPinnedModern(options?.versionNegotiation) && entry._modernFetch) {
       return { transport: modernFetchTransport(entry) };
@@ -30424,7 +30443,7 @@ async function resolveEntryTransport(entry, auth2, options) {
   }
   const entryAuth = resolveEntryAuth(entry.auth) ?? auth2;
   if ("url" in entry) {
-    const url2 = new URL(entry.url);
+    const url2 = parseHttpUrl(entry.url);
     const extraHeaders = entry.headers ?? {};
     return { transport: urlToTransport(url2, entryAuth, extraHeaders, options?.legacySSE) };
   }
@@ -30454,7 +30473,7 @@ async function resolveTransport(input, auth2, options) {
     };
   }
   if (typeof input === "string") {
-    const url2 = new URL(input);
+    const url2 = parseHttpUrl(input);
     return { transport: urlToTransport(url2, auth2, {}, options?.legacySSE) };
   }
   if (typeof input === "object" && input !== null && "start" in input && typeof input.start === "function") {
@@ -30480,7 +30499,7 @@ async function resolveTransport(input, auth2, options) {
     "Unrecognized transport input: expected a URL string, FastMCP server instance, mcpServers config object, StdioTransport, or SDK Transport"
   );
 }
-var StdioTransport, sseDeprecationWarned, IN_PROCESS_BASE_URL;
+var StdioTransport, STDIO_HINT, sseDeprecationWarned, IN_PROCESS_BASE_URL;
 var init_transports = __esm({
   "src/client/transports.ts"() {
     "use strict";
@@ -30498,6 +30517,7 @@ var init_transports = __esm({
         this.cwd = options?.cwd;
       }
     };
+    STDIO_HINT = `To run a local server script over stdio, pass an explicit StdioTransport (e.g. new StdioTransport('node', ['server.js'])) or an mcpServers entry with a "command" key.`;
     sseDeprecationWarned = false;
     IN_PROCESS_BASE_URL = "http://in-process.local/mcp";
   }
@@ -33793,7 +33813,7 @@ var init_inspect = __esm({
               // only case Python's inspect supports); over --url/--command the
               // generation is unknowable from the wire.
               generation: mode.kind === "inprocess" ? 2 : null,
-              fastmcpVersion: "1.7.0",
+              fastmcpVersion: "1.7.2",
               mcpVersion: "2.0.0",
               tools: tools2,
               prompts: prompts2,
@@ -47322,7 +47342,7 @@ init_format();
 var main = defineCommand({
   meta: {
     name: "fastmcp",
-    version: "1.7.0",
+    version: "1.7.2",
     description: "FastMCP CLI \u2014 build, run, and manage MCP servers"
   },
   args: {