@prefecthq/fastmcp-ts 0.0.5 → 0.1.0

package/dist/cli/entrypoint-runtime.cjs

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/cli/entrypoint-runtime.ts
+var import_node_url = require("url");
+var AUTO_DETECT_NAMES = ["default", "mcp", "server", "app"];
+function isFastMCPInstance(value) {
+  if (!value || typeof value !== "object") return false;
+  const obj = value;
+  return typeof obj["run"] === "function" && typeof obj["tool"] === "function" && typeof obj["resource"] === "function" && typeof obj["prompt"] === "function" && typeof obj["connect"] === "function";
+}
+function describe(value) {
+  if (value === null) return "null";
+  if (Array.isArray(value)) return "an array";
+  return `a ${typeof value}`;
+}
+function fail(message) {
+  console.error(`fastmcp: ${message}`);
+  process.exit(1);
+}
+async function resolveFactory(value, exportName, filePath) {
+  if (typeof value !== "function") return value;
+  try {
+    return await value();
+  } catch (err) {
+    fail(
+      `Failed to call entrypoint factory "${exportName}" in ${filePath}: ` + (err instanceof Error ? err.message : String(err))
+    );
+  }
+}
+async function main() {
+  const filePath = process.env["FASTMCP_ENTRYPOINT_FILE"];
+  if (!filePath) {
+    fail("internal error: FASTMCP_ENTRYPOINT_FILE was not set for the entrypoint bootstrap");
+  }
+  const explicitExport = process.env["FASTMCP_ENTRYPOINT_EXPORT"];
+  let mod;
+  try {
+    mod = await import((0, import_node_url.pathToFileURL)(filePath).href);
+  } catch (err) {
+    fail(
+      `Failed to load entrypoint file "${filePath}": ` + (err instanceof Error ? err.stack ?? err.message : String(err))
+    );
+  }
+  let resolved;
+  if (explicitExport) {
+    if (!(explicitExport in mod)) {
+      const available = Object.keys(mod).filter((k) => k !== "__esModule");
+      fail(
+        `Entrypoint export "${explicitExport}" not found in ${filePath}.` + (available.length > 0 ? ` Available exports: ${available.join(", ")}.` : " The file has no exports.")
+      );
+    }
+    const target = await resolveFactory(mod[explicitExport], explicitExport, filePath);
+    if (!isFastMCPInstance(target)) {
+      fail(
+        `Entrypoint export "${explicitExport}" in ${filePath} is not a FastMCP server (or a function that returns one). Got ${describe(target)}.`
+      );
+    }
+    resolved = target;
+  } else {
+    for (const name of AUTO_DETECT_NAMES) {
+      if (!(name in mod)) continue;
+      const candidate = mod[name];
+      if (isFastMCPInstance(candidate)) {
+        resolved = candidate;
+        break;
+      }
+    }
+    if (resolved === void 0) {
+      return;
+    }
+  }
+  if (resolved.isRunning) {
+    return;
+  }
+  await resolved.run();
+  if (resolved.address) {
+    const { host, port, path } = resolved.address;
+    process.stderr.write(`listening on http://${host}:${port}${path}
+`);
+  }
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});
+//# sourceMappingURL=entrypoint-runtime.cjs.map

package/dist/cli/entrypoint-runtime.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/entrypoint-runtime.ts"],"sourcesContent":["/**\n * Entrypoint bootstrap — spawned by the CLI (`run`, `inspect`, `list`, `call`,\n * `dev inspector`) instead of the user's server file directly.\n *\n * This mirrors Python FastMCP's `FileSystemSource` entrypoint resolution\n * (`fastmcp/utilities/mcp_server_config/v1/sources/filesystem.py`): import the\n * user's file, resolve a named export (or a factory function that returns a\n * server), and start it. Keeping this in a spawned subprocess (rather than\n * importing the user's file in the CLI's own process) preserves two things the\n * existing CLI already relies on: `tsx` transpilation for TypeScript files, and\n * process isolation so a crashing user server doesn't take down the CLI.\n *\n * Contract (set by the parent CLI process via environment variables):\n *   - FASTMCP_ENTRYPOINT_FILE: absolute path to the user's server file (required)\n *   - FASTMCP_ENTRYPOINT_EXPORT: export name to resolve. Omitted when the user\n *     didn't specify one, in which case a conventional name is auto-detected.\n *\n * Resolution order when FASTMCP_ENTRYPOINT_EXPORT is not set:\n *   `default`, `mcp`, `server`, `app` — the first of these that is already a\n *   FastMCP instance wins. Auto-detection deliberately does NOT call factory\n *   functions (mirroring Python FastMCP's `_find_server_object`, which only\n *   resolves factories for an explicit entrypoint) — invoking an arbitrary\n *   exported function as a side effect of guessing a name would be surprising,\n *   and a name match that isn't a FastMCP instance is skipped in favor of the\n *   next candidate rather than committing to it. Factory functions are only\n *   resolved when the export name is given explicitly (`file:export` or\n *   `--export`).\n *\n * Backwards compatibility: if no explicit export was requested and none of the\n * conventional names resolve to a valid entrypoint, this script assumes the\n * file already started its own server via top-level side effects (the\n * historical fastmcp-ts contract, e.g. `server.run()` at module scope) and\n * exits without error. An explicit export request that can't be resolved is\n * always a hard error.\n */\n\nimport { pathToFileURL } from 'node:url'\n\nconst AUTO_DETECT_NAMES = ['default', 'mcp', 'server', 'app']\n\ninterface RunnableFastMCP {\n  run(): Promise<void>\n  isRunning: boolean\n  address: { host: string; port: number; path: string } | null\n}\n\nfunction isFastMCPInstance(value: unknown): value is RunnableFastMCP {\n  if (!value || typeof value !== 'object') return false\n  const obj = value as Record<string, unknown>\n  return (\n    typeof obj['run'] === 'function' &&\n    typeof obj['tool'] === 'function' &&\n    typeof obj['resource'] === 'function' &&\n    typeof obj['prompt'] === 'function' &&\n    typeof obj['connect'] === 'function'\n  )\n}\n\nfunction describe(value: unknown): string {\n  if (value === null) return 'null'\n  if (Array.isArray(value)) return 'an array'\n  return `a ${typeof value}`\n}\n\nfunction fail(message: string): never {\n  console.error(`fastmcp: ${message}`)\n  process.exit(1)\n}\n\nasync function resolveFactory(\n  value: unknown,\n  exportName: string,\n  filePath: string,\n): Promise<unknown> {\n  if (typeof value !== 'function') return value\n  try {\n    return await (value as () => unknown)()\n  } catch (err) {\n    fail(\n      `Failed to call entrypoint factory \"${exportName}\" in ${filePath}: ` +\n        (err instanceof Error ? err.message : String(err)),\n    )\n  }\n}\n\nasync function main(): Promise<void> {\n  const filePath = process.env['FASTMCP_ENTRYPOINT_FILE']\n  if (!filePath) {\n    fail('internal error: FASTMCP_ENTRYPOINT_FILE was not set for the entrypoint bootstrap')\n  }\n\n  const explicitExport = process.env['FASTMCP_ENTRYPOINT_EXPORT']\n\n  let mod: Record<string, unknown>\n  try {\n    mod = (await import(pathToFileURL(filePath).href)) as Record<string, unknown>\n  } catch (err) {\n    fail(\n      `Failed to load entrypoint file \"${filePath}\": ` +\n        (err instanceof Error ? (err.stack ?? err.message) : String(err)),\n    )\n  }\n\n  let resolved: RunnableFastMCP | undefined\n\n  if (explicitExport) {\n    if (!(explicitExport in mod)) {\n      const available = Object.keys(mod).filter((k) => k !== '__esModule')\n      fail(\n        `Entrypoint export \"${explicitExport}\" not found in ${filePath}.` +\n          (available.length > 0\n            ? ` Available exports: ${available.join(', ')}.`\n            : ' The file has no exports.'),\n      )\n    }\n    const target = await resolveFactory(mod[explicitExport], explicitExport, filePath)\n    if (!isFastMCPInstance(target)) {\n      fail(\n        `Entrypoint export \"${explicitExport}\" in ${filePath} is not a FastMCP server ` +\n          `(or a function that returns one). Got ${describe(target)}.`,\n      )\n    }\n    resolved = target\n  } else {\n    for (const name of AUTO_DETECT_NAMES) {\n      if (!(name in mod)) continue\n      const candidate = mod[name]\n      // Only a direct FastMCP instance is auto-detected — a name match that\n      // isn't one (including a function, which would require calling it) is\n      // skipped in favor of the next conventional name rather than erroring\n      // or invoking it speculatively.\n      if (isFastMCPInstance(candidate)) {\n        resolved = candidate\n        break\n      }\n    }\n    if (resolved === undefined) {\n      // No conventional export resolved to a FastMCP instance. Assume this is\n      // a legacy self-running file (it started its own server via top-level\n      // side effects when imported above) and exit quietly.\n      return\n    }\n  }\n\n  if (resolved.isRunning) {\n    // The file already started this server itself (e.g. a top-level\n    // `server.run()` call) before we got a chance to. Don't start it twice.\n    return\n  }\n\n  await resolved.run()\n\n  // Mirrors the \"listening on <url>\" line the raw-SDK CLI test fixtures print\n  // themselves — FastMCP's own run() doesn't emit a startup banner, but the\n  // CLI's `run` command watches stderr for this text to detect a successful\n  // HTTP start (see spawnServer()'s \"started\" detection in commands/run.ts).\n  if (resolved.address) {\n    const { host, port, path } = resolved.address\n    process.stderr.write(`listening on http://${host}:${port}${path}\\n`)\n  }\n}\n\nmain().catch((err) => {\n  console.error(err)\n  process.exit(1)\n})\n"],"mappings":";;;;AAoCA,sBAA8B;AAE9B,IAAM,oBAAoB,CAAC,WAAW,OAAO,UAAU,KAAK;AAQ5D,SAAS,kBAAkB,OAA0C;AACnE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,MAAM;AACZ,SACE,OAAO,IAAI,KAAK,MAAM,cACtB,OAAO,IAAI,MAAM,MAAM,cACvB,OAAO,IAAI,UAAU,MAAM,cAC3B,OAAO,IAAI,QAAQ,MAAM,cACzB,OAAO,IAAI,SAAS,MAAM;AAE9B;AAEA,SAAS,SAAS,OAAwB;AACxC,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO;AACjC,SAAO,KAAK,OAAO,KAAK;AAC1B;AAEA,SAAS,KAAK,SAAwB;AACpC,UAAQ,MAAM,YAAY,OAAO,EAAE;AACnC,UAAQ,KAAK,CAAC;AAChB;AAEA,eAAe,eACb,OACA,YACA,UACkB;AAClB,MAAI,OAAO,UAAU,WAAY,QAAO;AACxC,MAAI;AACF,WAAO,MAAO,MAAwB;AAAA,EACxC,SAAS,KAAK;AACZ;AAAA,MACE,sCAAsC,UAAU,QAAQ,QAAQ,QAC7D,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAAA,IACpD;AAAA,EACF;AACF;AAEA,eAAe,OAAsB;AACnC,QAAM,WAAW,QAAQ,IAAI,yBAAyB;AACtD,MAAI,CAAC,UAAU;AACb,SAAK,kFAAkF;AAAA,EACzF;AAEA,QAAM,iBAAiB,QAAQ,IAAI,2BAA2B;AAE9D,MAAI;AACJ,MAAI;AACF,UAAO,MAAM,WAAO,+BAAc,QAAQ,EAAE;AAAA,EAC9C,SAAS,KAAK;AACZ;AAAA,MACE,mCAAmC,QAAQ,SACxC,eAAe,QAAS,IAAI,SAAS,IAAI,UAAW,OAAO,GAAG;AAAA,IACnE;AAAA,EACF;AAEA,MAAI;AAEJ,MAAI,gBAAgB;AAClB,QAAI,EAAE,kBAAkB,MAAM;AAC5B,YAAM,YAAY,OAAO,KAAK,GAAG,EAAE,OAAO,CAAC,MAAM,MAAM,YAAY;AACnE;AAAA,QACE,sBAAsB,cAAc,kBAAkB,QAAQ,OAC3D,UAAU,SAAS,IAChB,uBAAuB,UAAU,KAAK,IAAI,CAAC,MAC3C;AAAA,MACR;AAAA,IACF;AACA,UAAM,SAAS,MAAM,eAAe,IAAI,cAAc,GAAG,gBAAgB,QAAQ;AACjF,QAAI,CAAC,kBAAkB,MAAM,GAAG;AAC9B;AAAA,QACE,sBAAsB,cAAc,QAAQ,QAAQ,kEACT,SAAS,MAAM,CAAC;AAAA,MAC7D;AAAA,IACF;AACA,eAAW;AAAA,EACb,OAAO;AACL,eAAW,QAAQ,mBAAmB;AACpC,UAAI,EAAE,QAAQ,KAAM;AACpB,YAAM,YAAY,IAAI,IAAI;AAK1B,UAAI,kBAAkB,SAAS,GAAG;AAChC,mBAAW;AACX;AAAA,MACF;AAAA,IACF;AACA,QAAI,aAAa,QAAW;AAI1B;AAAA,IACF;AAAA,EACF;AAEA,MAAI,SAAS,WAAW;AAGtB;AAAA,EACF;AAEA,QAAM,SAAS,IAAI;AAMnB,MAAI,SAAS,SAAS;AACpB,UAAM,EAAE,MAAM,MAAM,KAAK,IAAI,SAAS;AACtC,YAAQ,OAAO,MAAM,uBAAuB,IAAI,IAAI,IAAI,GAAG,IAAI;AAAA,CAAI;AAAA,EACrE;AACF;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,MAAM,GAAG;AACjB,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":[]}

package/dist/cli/index.cjs

@@ -1172,7 +1172,7 @@ var init_version = __esm({
       async run({ args }) {
         if (args.json) setJsonMode(true);
         const data = {
-          fastmcp: "0.0.5",
+          fastmcp: "0.1.0",
           "mcp-sdk": "^1.29.0",
           node: process.version,
           platform: `${process.platform} ${process.arch}`
@@ -1188,16 +1188,24 @@ var init_version = __esm({
 });
 
 // src/cli/utils/file-spec.ts
-function parseFileSpec(spec) {
+function parseFileSpec(spec, exportOverride) {
   const colonIdx = spec.lastIndexOf(":");
   let filePart;
   let exportName;
+  let explicitExport;
   if (colonIdx > 1) {
     filePart = spec.slice(0, colonIdx);
-    exportName = spec.slice(colonIdx + 1) || "default";
+    exportName = spec.slice(colonIdx + 1);
+    explicitExport = exportName.length > 0;
+    if (!explicitExport) exportName = "default";
   } else {
     filePart = spec;
     exportName = "default";
+    explicitExport = false;
+  }
+  if (exportOverride) {
+    exportName = exportOverride;
+    explicitExport = true;
   }
   const filePath = (0, import_node_path.resolve)(process.cwd(), filePart);
   if (!(0, import_node_fs.existsSync)(filePath)) {
@@ -1205,7 +1213,7 @@ function parseFileSpec(spec) {
   }
   const ext = (0, import_node_path.extname)(filePath).toLowerCase();
   const isTypeScript = ext === ".ts" || ext === ".tsx" || ext === ".mts";
-  return { filePath, exportName, isTypeScript };
+  return { filePath, exportName, explicitExport, isTypeScript };
 }
 var import_node_fs, import_node_path;
 var init_file_spec = __esm({
@@ -1216,6 +1224,27 @@ var init_file_spec = __esm({
   }
 });
 
+// src/cli/utils/entrypoint-bootstrap.ts
+function resolveEntrypointBootstrapPath() {
+  return (0, import_node_path2.join)(__dirname, "entrypoint-runtime.cjs");
+}
+function buildEntrypointEnv(spec) {
+  const env2 = {
+    FASTMCP_ENTRYPOINT_FILE: spec.filePath
+  };
+  if (spec.explicitExport) {
+    env2["FASTMCP_ENTRYPOINT_EXPORT"] = spec.exportName;
+  }
+  return env2;
+}
+var import_node_path2;
+var init_entrypoint_bootstrap = __esm({
+  "src/cli/utils/entrypoint-bootstrap.ts"() {
+    "use strict";
+    import_node_path2 = require("path");
+  }
+});
+
 // src/cli/utils/error.ts
 function cliError(message, opts = {}) {
   process.stderr.write(`${theme.error(symbols.failure)} ${theme.error(message)}
@@ -1274,12 +1303,12 @@ function readdirp(root, options = {}) {
   options.root = root;
   return new ReaddirpStream(options);
 }
-var import_promises, import_node_path2, import_node_stream, EntryTypes, defaultOptions, RECURSIVE_ERROR_CODE, NORMAL_FLOW_ERRORS, ALL_TYPES, DIR_TYPES, FILE_TYPES, isNormalFlowError, wantBigintFsStats, emptyFn, normalizeFilter, ReaddirpStream;
+var import_promises, import_node_path3, import_node_stream, EntryTypes, defaultOptions, RECURSIVE_ERROR_CODE, NORMAL_FLOW_ERRORS, ALL_TYPES, DIR_TYPES, FILE_TYPES, isNormalFlowError, wantBigintFsStats, emptyFn, normalizeFilter, ReaddirpStream;
 var init_readdirp = __esm({
   "node_modules/readdirp/index.js"() {
     "use strict";
     import_promises = require("fs/promises");
-    import_node_path2 = require("path");
+    import_node_path3 = require("path");
     import_node_stream = require("stream");
     EntryTypes = {
       FILE_TYPE: "files",
@@ -1369,7 +1398,7 @@ var init_readdirp = __esm({
         this._wantsDir = type ? DIR_TYPES.has(type) : false;
         this._wantsFile = type ? FILE_TYPES.has(type) : false;
         this._wantsEverything = type === EntryTypes.EVERYTHING_TYPE;
-        this._root = (0, import_node_path2.resolve)(root);
+        this._root = (0, import_node_path3.resolve)(root);
         this._isDirent = !opts.alwaysStat;
         this._statsProp = this._isDirent ? "dirent" : "stats";
         this._rdOptions = { encoding: "utf8", withFileTypes: this._isDirent };
@@ -1440,8 +1469,8 @@ var init_readdirp = __esm({
         let entry;
         const basename3 = this._isDirent ? dirent.name : dirent;
         try {
-          const fullPath = (0, import_node_path2.resolve)((0, import_node_path2.join)(path, basename3));
-          entry = { path: (0, import_node_path2.relative)(this._root, fullPath), fullPath, basename: basename3 };
+          const fullPath = (0, import_node_path3.resolve)((0, import_node_path3.join)(path, basename3));
+          entry = { path: (0, import_node_path3.relative)(this._root, fullPath), fullPath, basename: basename3 };
           entry[this._statsProp] = this._isDirent ? dirent : await this._stat(fullPath);
         } catch (err) {
           this._onError(err);
@@ -1475,7 +1504,7 @@ var init_readdirp = __esm({
             }
             if (entryRealPathStats.isDirectory()) {
               const len = entryRealPath.length;
-              if (full.startsWith(entryRealPath) && full.substr(len, 1) === import_node_path2.sep) {
+              if (full.startsWith(entryRealPath) && full.substr(len, 1) === import_node_path3.sep) {
                 const recursiveError = new Error(`Circular symlink detected: "${full}" points to "${entryRealPath}"`);
                 recursiveError.code = RECURSIVE_ERROR_CODE;
                 return this._onError(recursiveError);
@@ -3019,10 +3048,11 @@ var run_exports = {};
 __export(run_exports, {
   default: () => run_default
 });
-function spawnServer(filePath, isTypeScript, env2) {
-  const [cmd, args] = isTypeScript ? ["npx", ["tsx", filePath]] : ["node", [filePath]];
+function spawnServer(spec, env2) {
+  const bootstrapPath = resolveEntrypointBootstrapPath();
+  const [cmd, args] = spec.isTypeScript ? ["npx", ["tsx", bootstrapPath]] : ["node", [bootstrapPath]];
   return (0, import_node_child_process.spawn)(cmd, args, {
-    env: { ...process.env, ...env2 },
+    env: { ...process.env, ...buildEntrypointEnv(spec), ...env2 },
     stdio: ["inherit", "pipe", "pipe"]
   });
 }
@@ -3033,6 +3063,7 @@ var init_run = __esm({
     init_dist();
     import_node_child_process = require("child_process");
     init_file_spec();
+    init_entrypoint_bootstrap();
     init_error();
     init_theme();
     init_symbols();
@@ -3041,7 +3072,9 @@ var init_run = __esm({
       args: {
         spec: { type: "positional", description: "File spec (e.g. server.ts or server.ts:app)", required: true },
         transport: { type: "string", description: "Transport type (stdio|http|sse)", default: "stdio" },
+        host: { type: "string", description: "HTTP host to bind to (for http transport)" },
         port: { type: "string", description: "HTTP port (for http/sse transports)" },
+        path: { type: "string", description: "HTTP path to serve on (for http transport)" },
         reload: { type: "boolean", description: "Restart on file change", default: false }
       },
       async run({ args }) {
@@ -3054,8 +3087,10 @@ var init_run = __esm({
         const transportEnv = {
           MCP_TRANSPORT: args.transport
         };
+        if (args.host) transportEnv["MCP_HOST"] = args.host;
         if (args.port) transportEnv["MCP_PORT"] = args.port;
-        let child = spawnServer(fileSpec.filePath, fileSpec.isTypeScript, transportEnv);
+        if (args.path) transportEnv["MCP_PATH"] = args.path;
+        let child = spawnServer(fileSpec, transportEnv);
         let started = false;
         function attachHandlers(proc) {
           proc.stdout?.on("data", (chunk) => {
@@ -3091,7 +3126,7 @@ var init_run = __esm({
 `);
             child.kill();
             started = false;
-            child = spawnServer(fileSpec.filePath, fileSpec.isTypeScript, transportEnv);
+            child = spawnServer(fileSpec, transportEnv);
             attachHandlers(child);
           });
         }
@@ -29381,8 +29416,11 @@ async function connectClient(mode, auth2) {
     return client2;
   }
   const { spec } = mode;
-  const [command, cmdArgs] = spec.isTypeScript ? ["npx", ["tsx", spec.filePath]] : ["node", [spec.filePath]];
-  const transport = new StdioTransport(command, cmdArgs, { env: stdioEnv });
+  const bootstrapPath = resolveEntrypointBootstrapPath();
+  const [command, cmdArgs] = spec.isTypeScript ? ["npx", ["tsx", bootstrapPath]] : ["node", [bootstrapPath]];
+  const transport = new StdioTransport(command, cmdArgs, {
+    env: { ...stdioEnv, ...buildEntrypointEnv(spec) }
+  });
   const client = new Client2(transport, { auth: auth2 });
   await client.connect();
   return client;
@@ -29401,6 +29439,7 @@ var init_connect = __esm({
     "use strict";
     init_client3();
     init_transports();
+    init_entrypoint_bootstrap();
   }
 });
 
@@ -30087,7 +30126,7 @@ var init_dist6 = __esm({
 function Ze() {
   return import_node_process4.default.platform !== "win32" ? import_node_process4.default.env.TERM !== "linux" : !!import_node_process4.default.env.CI || !!import_node_process4.default.env.WT_SESSION || !!import_node_process4.default.env.TERMINUS_SUBLIME || import_node_process4.default.env.ConEmuTask === "{cmd::Cmder}" || import_node_process4.default.env.TERM_PROGRAM === "Terminus-Sublime" || import_node_process4.default.env.TERM_PROGRAM === "vscode" || import_node_process4.default.env.TERM === "xterm-256color" || import_node_process4.default.env.TERM === "alacritty" || import_node_process4.default.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
-var import_node_util3, import_node_process4, import_node_fs4, import_node_path3, import_sisteransi2, ee, ae, w2, _e, oe, ue, F, le, d, E2, Ie, Ee, z3, H2, te, U, J, xe, se, ce, Ge, $e, de, Oe, he, pe, me, ge, V2, ot2, Ct, fe, Ve, je;
+var import_node_util3, import_node_process4, import_node_fs4, import_node_path4, import_sisteransi2, ee, ae, w2, _e, oe, ue, F, le, d, E2, Ie, Ee, z3, H2, te, U, J, xe, se, ce, Ge, $e, de, Oe, he, pe, me, ge, V2, ot2, Ct, fe, Ve, je;
 var init_dist7 = __esm({
   "node_modules/@clack/prompts/dist/index.mjs"() {
     "use strict";
@@ -30098,7 +30137,7 @@ var init_dist7 = __esm({
     init_main();
     init_dist5();
     import_node_fs4 = require("fs");
-    import_node_path3 = require("path");
+    import_node_path4 = require("path");
     import_sisteransi2 = __toESM(require_src(), 1);
     ee = Ze();
     ae = () => process.env.CI === "true";
@@ -32121,6 +32160,7 @@ var init_inspect = __esm({
         url: { type: "string", description: "Server URL" },
         command: { type: "string", description: "stdio server command" },
         file: { type: "string", description: "Server file (e.g. server.ts)" },
+        export: { type: "string", description: "Named export to resolve (e.g. server); overrides file:export syntax" },
         auth: { type: "string", description: "Bearer token" },
         json: { type: "boolean", description: "Output JSON", default: false }
       },
@@ -32133,7 +32173,7 @@ var init_inspect = __esm({
         let fileSpec;
         if (args.file) {
           try {
-            fileSpec = parseFileSpec(args.file);
+            fileSpec = parseFileSpec(args.file, args.export);
           } catch (err) {
             cliError(formatError(err));
           }
@@ -32234,6 +32274,7 @@ var init_list = __esm({
         url: { type: "string", description: "Server URL" },
         command: { type: "string", description: "stdio server command" },
         file: { type: "string", description: "Server file (e.g. server.ts)" },
+        export: { type: "string", description: "Named export to resolve (e.g. server); overrides file:export syntax" },
         auth: { type: "string", description: "Bearer token" },
         resources: { type: "boolean", description: "Also list resources", default: false },
         prompts: { type: "boolean", description: "Also list prompts", default: false },
@@ -32249,7 +32290,7 @@ var init_list = __esm({
         let fileSpec;
         if (args.file) {
           try {
-            fileSpec = parseFileSpec(args.file);
+            fileSpec = parseFileSpec(args.file, args.export);
           } catch (err) {
             cliError(formatError(err));
           }
@@ -32524,6 +32565,7 @@ var init_call = __esm({
         url: { type: "string", description: "Server URL" },
         command: { type: "string", description: "stdio server command" },
         file: { type: "string", description: "Server file (e.g. server.ts)" },
+        export: { type: "string", description: "Named export to resolve (e.g. server); overrides file:export syntax" },
         auth: { type: "string", description: "Bearer token" },
         "input-json": { type: "string", description: "Raw JSON input instead of key=value args" },
         json: { type: "boolean", description: "Output JSON", default: false }
@@ -32537,7 +32579,7 @@ var init_call = __esm({
         let fileSpec;
         if (args.file) {
           try {
-            fileSpec = parseFileSpec(args.file);
+            fileSpec = parseFileSpec(args.file, args.export);
           } catch (err) {
             cliError(formatError(err));
           }
@@ -32573,7 +32615,7 @@ var init_call = __esm({
             { hint: suggestion ? `Did you mean "${suggestion}"?` : void 0 }
           );
         }
-        const flagValues = new Set([target, args.url, args.command, args.file, args.auth, args["input-json"]].filter(Boolean));
+        const flagValues = new Set([target, args.url, args.command, args.file, args.export, args.auth, args["input-json"]].filter(Boolean));
         const kvRaw = rawArgs.filter((a) => !a.startsWith("-") && !flagValues.has(a));
         let input = args["input-json"] ? JSON.parse(args["input-json"]) : parseKvArgs(kvRaw);
         if (matchedTool?.inputSchema) {
@@ -39939,11 +39981,11 @@ var require_dist2 = __commonJS({
 function getConfigPaths() {
   const home = (0, import_node_os3.homedir)();
   const platform2 = process.platform;
-  const claudeDesktop = platform2 === "darwin" ? (0, import_node_path4.join)(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : platform2 === "win32" ? (0, import_node_path4.join)(process.env["APPDATA"] ?? (0, import_node_path4.join)(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json") : (0, import_node_path4.join)(home, ".config", "Claude", "claude_desktop_config.json");
+  const claudeDesktop = platform2 === "darwin" ? (0, import_node_path5.join)(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : platform2 === "win32" ? (0, import_node_path5.join)(process.env["APPDATA"] ?? (0, import_node_path5.join)(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json") : (0, import_node_path5.join)(home, ".config", "Claude", "claude_desktop_config.json");
   return {
     "claude-code": {
       name: "claude-code",
-      path: (0, import_node_path4.join)(home, ".claude.json"),
+      path: (0, import_node_path5.join)(home, ".claude.json"),
       format: "json"
     },
     "claude-desktop": {
@@ -39953,22 +39995,22 @@ function getConfigPaths() {
     },
     cursor: {
       name: "cursor",
-      path: (0, import_node_path4.join)(home, ".cursor", "mcp.json"),
+      path: (0, import_node_path5.join)(home, ".cursor", "mcp.json"),
       format: "json"
     },
     gemini: {
       name: "gemini",
-      path: (0, import_node_path4.join)(home, ".gemini", "settings.json"),
+      path: (0, import_node_path5.join)(home, ".gemini", "settings.json"),
       format: "json"
     },
     goose: {
       name: "goose",
-      path: (0, import_node_path4.join)(home, ".config", "goose", "config.yaml"),
+      path: (0, import_node_path5.join)(home, ".config", "goose", "config.yaml"),
       format: "yaml"
     },
     "mcp-json": {
       name: "mcp-json",
-      path: (0, import_node_path4.resolve)(process.cwd(), "mcp.json"),
+      path: (0, import_node_path5.resolve)(process.cwd(), "mcp.json"),
       format: "json"
     }
   };
@@ -39982,12 +40024,12 @@ function writeConfig(path, data, format2) {
   const content = format2 === "yaml" ? import_yaml.default.stringify(data) : JSON.stringify(data, null, 2) + "\n";
   (0, import_node_fs5.writeFileSync)(path, content, "utf8");
 }
-var import_node_os3, import_node_path4, import_node_fs5, import_yaml;
+var import_node_os3, import_node_path5, import_node_fs5, import_yaml;
 var init_config_paths = __esm({
   "src/cli/utils/config-paths.ts"() {
     "use strict";
     import_node_os3 = require("os");
-    import_node_path4 = require("path");
+    import_node_path5 = require("path");
     import_node_fs5 = require("fs");
     import_yaml = __toESM(require_dist2(), 1);
   }
@@ -45169,7 +45211,7 @@ function parseEnvMap(raw) {
   );
 }
 function ensureDir(path) {
-  const dir = (0, import_node_path5.dirname)(path);
+  const dir = (0, import_node_path6.dirname)(path);
   if (!(0, import_node_fs6.existsSync)(dir)) {
     (0, import_node_fs6.mkdirSync)(dir, { recursive: true });
   }
@@ -45256,12 +45298,12 @@ async function installServer(opts) {
     cliError(err instanceof Error ? err.message : String(err));
   }
 }
-var import_node_fs6, import_node_path5;
+var import_node_fs6, import_node_path6;
 var init_shared = __esm({
   "src/cli/commands/install/shared.ts"() {
     "use strict";
     import_node_fs6 = require("fs");
-    import_node_path5 = require("path");
+    import_node_path6 = require("path");
     init_dist8();
     init_dist7();
     init_config_paths();
@@ -45550,6 +45592,7 @@ var init_inspector = __esm({
     init_dist();
     import_node_child_process2 = require("child_process");
     init_file_spec();
+    init_entrypoint_bootstrap();
     init_error();
     init_output();
     init_theme();
@@ -45568,7 +45611,8 @@ var init_inspector = __esm({
         } catch (err) {
           cliError(formatError(err));
         }
-        const serverCmd = fileSpec.isTypeScript ? `npx tsx ${fileSpec.filePath}` : `node ${fileSpec.filePath}`;
+        const bootstrapPath = resolveEntrypointBootstrapPath();
+        const serverCmd = fileSpec.isTypeScript ? `npx tsx ${bootstrapPath}` : `node ${bootstrapPath}`;
         await withSpinner(
           "Starting inspector\u2026",
           () => new Promise((resolve5) => setTimeout(resolve5, 300))
@@ -45576,7 +45620,11 @@ var init_inspector = __esm({
         const inspectorProcess = (0, import_node_child_process2.spawn)(
           "npx",
           ["@modelcontextprotocol/inspector", "--server", serverCmd],
-          { stdio: "inherit", shell: true, env: { ...process.env, MCP_TRANSPORT: "stdio" } }
+          {
+            stdio: "inherit",
+            shell: true,
+            env: { ...process.env, MCP_TRANSPORT: "stdio", ...buildEntrypointEnv(fileSpec) }
+          }
         );
         log.info(`Inspector running \u2014 ${theme.url(`http://localhost:${args.port}`)}`);
         const { watch: watch2 } = await Promise.resolve().then(() => (init_chokidar(), chokidar_exports));
@@ -45623,7 +45671,7 @@ init_format();
 var main = defineCommand({
   meta: {
     name: "fastmcp",
-    version: "0.0.5",
+    version: "0.1.0",
     description: "FastMCP CLI \u2014 build, run, and manage MCP servers"
   },
   args: {