mountly-mcp 0.0.0 → 4.0.0

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `mountly-mcp dev` — build the View, serve it in a real sandboxed MCP Apps\n * host, and rebuild on change.\n *\n * Config comes from the `mountlyMcpViews()` plugin already in vite.config.ts,\n * so there is nothing new to configure.\n */\nimport { readFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport { startDevHost } from \"./dev/index.js\";\nimport type { ConnectedMcpServer } from \"./dev/connect-server.js\";\nimport type { MountlyMcpViteApi, MountlyMcpViewOptions } from \"./vite/index.js\";\n\ninterface Args {\n  config?: string;\n  fixtures?: string;\n  server?: string;\n  app?: string;\n  port?: number;\n  open: boolean;\n}\n\ninterface VerifyArgs {\n  manifest?: string;\n  html: string[];\n  strict: boolean;\n  render: boolean;\n  json: boolean;\n}\n\ninterface BuildArgs {\n  config?: string;\n}\n\nfunction parseArgs(argv: ReadonlyArray<string>): Args {\n  const args: Args = { open: true };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      i += 1;\n      return value;\n    };\n    if (arg === \"--config\" || arg === \"-c\") args.config = next();\n    else if (arg === \"--fixtures\" || arg === \"-f\") args.fixtures = next();\n    else if (arg === \"--server\" || arg === \"-s\") args.server = next();\n    else if (arg === \"--app\" || arg === \"-a\") args.app = next();\n    else if (arg === \"--port\" || arg === \"-p\") args.port = Number(next());\n    else if (arg === \"--no-open\") args.open = false;\n    else if (arg === \"--help\" || arg === \"-h\") {\n      printUsage();\n      process.exit(0);\n    } else throw new Error(`mountly-mcp: unknown option '${arg}'`);\n  }\n  return args;\n}\n\nfunction parseVerifyArgs(argv: ReadonlyArray<string>): VerifyArgs {\n  const args: VerifyArgs = { html: [], strict: false, render: false, json: false };\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    const next = (): string => {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      i += 1;\n      return value;\n    };\n    if (arg === \"--manifest\" || arg === \"-m\") args.manifest = next();\n    else if (arg === \"--html\") args.html.push(next());\n    else if (arg === \"--strict\") args.strict = true;\n    else if (arg === \"--render\") args.render = true;\n    else if (arg === \"--json\") args.json = true;\n    else throw new Error(`mountly-mcp: unknown verify option '${arg}'`);\n  }\n  if (args.manifest && args.html.length > 0) {\n    throw new Error(\"mountly-mcp: verify accepts either --manifest or --html, not both\");\n  }\n  return args;\n}\n\nfunction parseBuildArgs(argv: ReadonlyArray<string>): BuildArgs {\n  const args: BuildArgs = {};\n  for (let i = 0; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--config\" || arg === \"-c\") {\n      const value = argv[i + 1];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      args.config = value;\n      i += 1;\n    } else throw new Error(`mountly-mcp: unknown build option '${arg}'`);\n  }\n  return args;\n}\n\nfunction printUsage(): void {\n  process.stdout.write(`mountly-mcp — create, build, develop, and verify MCP Apps\n\nUsage:\n  mountly-mcp create <name> [options]\n  mountly-mcp build [options]\n  mountly-mcp dev [options]\n  mountly-mcp verify [options]\n\nCreate options:\n  -f, --framework <name>  react | vue | svelte (default: react)\n      --dir <path>        output directory (default: ./<name>)\n\nDev / build options:\n  -c, --config <path>    vite config to read the View from (default: auto)\n  -f, --fixtures <path>  JSON of named samples (default: mcp.fixtures.json)\n  -s, --server <path>    module default-exporting your MCP server, to call real tools\n  -a, --app <name>       View to develop (required when the manifest has several)\n  -p, --port <number>    host port (default: 5179; the sandbox takes the next one)\n      --no-open          don't open a browser\n  -h, --help             show this\n\nVerify options:\n  -m, --manifest <path>  manifest to verify (default: dist/mountly-mcp.manifest.json)\n      --html <path>      transitional single-View HTML; repeat for several\n      --strict           fail when warnings are present\n      --render           require each View to mount with content in Chromium (needs playwright)\n      --json             output the conformance report as JSON\n\nGreenfield: prefer \\`mountly-mcp create\\` — do not clone the Mountly monorepo.\n\nThe View's entry, uri and name come from the mountlyMcpViews() plugin in\nyour vite config, so there is nothing extra to configure.\n\nWithout --server each fixture value is delivered as structuredContent. With\n--server it is the tool's arguments instead, the view receives what the real\ntool returns, and tool calls the view makes itself are routed to your server.\n`);\n}\n\nasync function buildApps(args: BuildArgs): Promise<void> {\n  const { createBuilder } = await import(\"vite\");\n  const builder = await createBuilder({ configFile: args.config }, false);\n  await builder.buildApp();\n}\n\nasync function verify(args: VerifyArgs): Promise<void> {\n  const { formatConformanceReport, verifyMcpApps } = await import(\"./testing/index.js\");\n  const report = await verifyMcpApps({\n    manifestPath: args.manifest,\n    htmlPaths: args.html.length > 0 ? args.html : undefined,\n    render: args.render,\n  });\n  process.stdout.write(\n    args.json ? JSON.stringify(report, null, 2) : formatConformanceReport(report),\n  );\n  if (!report.ok || (args.strict && report.diagnostics.length > 0)) process.exitCode = 1;\n}\n\n/**\n * Read the View's options back out of the vite config. The plugin publishes\n * them on `api.mountlyMcp`, so this stays correct if its option shape changes.\n */\nasync function loadViewOptions(\n  configFile: string | undefined,\n  appName: string | undefined,\n): Promise<{ options: MountlyMcpViewOptions; outDir: string; root: string }> {\n  const { loadConfigFromFile } = await import(\"vite\");\n  const loaded = await loadConfigFromFile({ command: \"build\", mode: \"development\" }, configFile);\n  if (!loaded) {\n    throw new Error(\n      \"mountly-mcp: no vite config found. Pass --config, or add mountlyMcpViews() to vite.config.ts.\",\n    );\n  }\n  // Flattened as unknown[]: vite's PluginOption is recursively nested, and\n  // asking TS to flatten it by its own type sends the checker infinite.\n  const plugins = ((loaded.config.plugins ?? []) as unknown[]).flat(\n    Number.POSITIVE_INFINITY,\n  ) as Array<{ name?: string; api?: { mountlyMcp?: MountlyMcpViteApi } } | null>;\n  const plugin = plugins.find((p) => p?.api?.mountlyMcp);\n  if (!plugin?.api?.mountlyMcp) {\n    throw new Error(\n      `mountly-mcp: no mountlyMcpViews() plugin in ${loaded.path}. Add it to the plugins array.`,\n    );\n  }\n  const apps = plugin.api.mountlyMcp.apps;\n  if (apps.length > 1 && appName === undefined) {\n    throw new Error(\n      `mountly-mcp: this build contains several Views; pass --app <name>. Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  const selected = appName === undefined ? apps[0] : apps.find((app) => app.name === appName);\n  if (!selected) {\n    throw new Error(\n      `mountly-mcp: no View named '${String(appName)}'. Available: ${apps.map((app) => app.name).join(\", \")}`,\n    );\n  }\n  return {\n    options: selected,\n    outDir: (loaded.config.build?.outDir as string | undefined) ?? \"dist\",\n    root: (loaded.config.root as string | undefined) ?? process.cwd(),\n  };\n}\n\n/**\n * Vite empties the out dir at the start of every build and the plugin writes\n * the resource in `closeBundle`, so the watcher's END event can arrive while\n * the files are still missing. Wait for the artifact rather than trusting the\n * event ordering — this also covers a build that failed and wrote nothing.\n */\nasync function waitForFile(path: string, timeoutMs = 15_000): Promise<void> {\n  const deadline = Date.now() + timeoutMs;\n  for (;;) {\n    try {\n      await readFile(path);\n      return;\n    } catch {\n      if (Date.now() > deadline) throw new Error(`mountly-mcp: timed out waiting for ${path}`);\n      await new Promise((done) => setTimeout(done, 50));\n    }\n  }\n}\n\nasync function loadFixtures(path: string | undefined): Promise<Record<string, unknown>> {\n  const file = path ?? \"mcp.fixtures.json\";\n  try {\n    return JSON.parse(await readFile(resolve(file), \"utf8\")) as Record<string, unknown>;\n  } catch (error) {\n    // An explicit --fixtures that doesn't load is a mistake worth reporting;\n    // the default one simply being absent is not.\n    if (path) throw new Error(`mountly-mcp: could not read fixtures '${file}': ${String(error)}`);\n    return {};\n  }\n}\n\nasync function dev(args: Args): Promise<void> {\n  const { options, outDir, root } = await loadViewOptions(args.config, args.app);\n  const fixtures = await loadFixtures(args.fixtures);\n\n  // Connected after the first build, not here: a server module typically reads\n  // the View it serves, which does not exist yet on a cold checkout.\n  let server: ConnectedMcpServer | undefined;\n  let toolName: string | undefined;\n\n  const { build } = await import(\"vite\");\n  const htmlPath = options.output\n    ? resolve(root, options.output)\n    : resolve(root, outDir, `${options.name}.html`);\n\n  // A watching build: vite rebuilds on change, and each rebuild bumps the\n  // version the browser is polling, which reloads it.\n  let host: Awaited<ReturnType<typeof startDevHost>> | undefined;\n  let started = false;\n\n  const previousSelectedApp = process.env.MOUNTLY_MCP_SELECTED_APP;\n  process.env.MOUNTLY_MCP_SELECTED_APP = options.name;\n  const watcher = await build({\n    configFile: args.config ?? undefined,\n    build: { watch: {} },\n    logLevel: \"warn\",\n  }).finally(() => {\n    if (previousSelectedApp === undefined) delete process.env.MOUNTLY_MCP_SELECTED_APP;\n    else process.env.MOUNTLY_MCP_SELECTED_APP = previousSelectedApp;\n  });\n\n  // `build({ watch })` returns a rollup watcher; the first BUNDLE_END means the\n  // View exists on disk and the host has something to serve.\n  const rollupWatcher = watcher as unknown as {\n    on(event: \"event\", cb: (e: { code: string; error?: Error }) => void): void;\n    close(): Promise<void>;\n  };\n\n  rollupWatcher.on(\"event\", (event) => {\n    if (event.code === \"ERROR\") {\n      process.stderr.write(`mountly-mcp: build failed — ${event.error?.message ?? \"unknown\"}\\n`);\n      return;\n    }\n    if (event.code !== \"END\") return;\n    if (started) {\n      void waitForFile(`${htmlPath}.meta.json`).then(\n        () => {\n          host?.reload();\n          process.stdout.write(\"mountly-mcp: rebuilt\\n\");\n        },\n        (error: unknown) => process.stderr.write(`${String(error)}\\n`),\n      );\n      return;\n    }\n    started = true;\n    void (async () => {\n      await waitForFile(`${htmlPath}.meta.json`);\n      if (args.server) {\n        const { connectMcpServer } = await import(\"./dev/connect-server.js\");\n        server = await connectMcpServer(args.server);\n        toolName = await server.toolFor(options.uri);\n        if (!toolName) {\n          throw new Error(\n            `mountly-mcp: server '${args.server}' has no tool linked to View '${options.uri}'`,\n          );\n        }\n      }\n      host = await startDevHost({\n        htmlPath,\n        fixtures,\n        toolInput: {},\n        toolName,\n        callTool: server?.callTool,\n        hostPort: args.port,\n      });\n      process.stdout.write(\n        `\\n  mountly-mcp dev\\n` +\n          `  host     ${host.hostUrl}\\n` +\n          `  sandbox  ${host.sandboxUrl}\\n` +\n          `  view     ${htmlPath}\\n` +\n          `  fixtures ${Object.keys(fixtures).length || \"none — pass --fixtures\"}\\n` +\n          `  server   ${server ? `${args.server} → ${toolName ?? \"no tool bound to \" + options.uri}` : \"none — fixtures deliver directly\"}\\n\\n` +\n          `  watching for changes; ctrl+c to stop\\n\\n`,\n      );\n      if (args.open) {\n        const { spawn } = await import(\"node:child_process\");\n        const opener =\n          process.platform === \"darwin\"\n            ? \"open\"\n            : process.platform === \"win32\"\n              ? \"start\"\n              : \"xdg-open\";\n        spawn(opener, [host.hostUrl], { stdio: \"ignore\", detached: true, shell: true }).unref();\n      }\n    })().catch((error: unknown) => {\n      // Startup runs inside a watcher callback, where a rejection would\n      // otherwise be silent and leave the process alive with no host.\n      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n      void Promise.all([rollupWatcher.close(), server?.close()]).finally(() => process.exit(1));\n    });\n  });\n\n  const shutdown = (): void => {\n    void (async () => {\n      await rollupWatcher.close();\n      await host?.close();\n      await server?.close();\n      process.exit(0);\n    })();\n  };\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n\nasync function main(): Promise<void> {\n  const [command, ...rest] = process.argv.slice(2);\n  if (command === undefined || command === \"--help\" || command === \"-h\") {\n    printUsage();\n    process.exit(command === undefined ? 1 : 0);\n  }\n  if (command === \"create\") {\n    const { createProject, parseCreateArgs } = await import(\"./create.js\");\n    return createProject(parseCreateArgs(rest));\n  }\n  if (command === \"dev\") return dev(parseArgs(rest));\n  if (command === \"build\") return buildApps(parseBuildArgs(rest));\n  if (command === \"verify\") return verify(parseVerifyArgs(rest));\n  process.stderr.write(`mountly-mcp: unknown command '${command}'. Try 'mountly-mcp --help'.\\n`);\n  process.exit(1);\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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","names":[]}

package/dist/connect-server-7L4HGKKL.js

@@ -0,0 +1,7 @@
+import {
+  connectMcpServer
+} from "./chunk-UECZA34Q.js";
+export {
+  connectMcpServer
+};
+//# sourceMappingURL=connect-server-7L4HGKKL.js.map

package/dist/connect-server-7L4HGKKL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/create.d.ts

@@ -0,0 +1,10 @@
+declare const SUPPORTED: readonly ["react", "vue", "svelte"];
+type Framework = (typeof SUPPORTED)[number];
+export interface CreateArgs {
+    name: string;
+    framework: Framework;
+    dir: string;
+}
+export declare function parseCreateArgs(argv: ReadonlyArray<string>): CreateArgs;
+export declare function createProject(args: CreateArgs): Promise<void>;
+export {};

package/dist/create.js

@@ -0,0 +1,107 @@
+// src/create.ts
+import {
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  unlinkSync,
+  writeFileSync
+} from "fs";
+import { dirname, join, resolve } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var PACKAGE_ROOT = resolve(__dirname, "..");
+var TEMPLATES = resolve(PACKAGE_ROOT, "templates");
+var SUPPORTED = ["react", "vue", "svelte"];
+function parseCreateArgs(argv) {
+  const name = argv[0];
+  if (!name || name.startsWith("-")) {
+    throw new Error(
+      "mountly-mcp create requires a project name. e.g. mountly-mcp create my-app --framework react"
+    );
+  }
+  let framework = "react";
+  let dir = `./${name}`;
+  for (let i = 1; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--framework" || arg === "-f") {
+      const value = argv[++i];
+      if (value === void 0) throw new Error(`mountly-mcp: ${arg} needs a value`);
+      if (!SUPPORTED.includes(value)) {
+        throw new Error(
+          `mountly-mcp: framework "${value}" not supported. Available: ${SUPPORTED.join(", ")}`
+        );
+      }
+      framework = value;
+    } else if (arg === "--dir") {
+      const value = argv[++i];
+      if (value === void 0) throw new Error("mountly-mcp: --dir needs a value");
+      dir = value;
+    } else {
+      throw new Error(`mountly-mcp: unknown create option '${arg}'`);
+    }
+  }
+  return { name, framework, dir };
+}
+function slugify(name) {
+  return name.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function renderTemplates(dir, ctx) {
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      renderTemplates(full, ctx);
+      continue;
+    }
+    if (!entry.endsWith(".tmpl")) continue;
+    let content = readFileSync(full, "utf8");
+    for (const [key, value] of Object.entries(ctx)) {
+      content = content.split(`{{${key}}}`).join(value);
+    }
+    writeFileSync(full.replace(/\.tmpl$/, ""), content);
+    unlinkSync(full);
+  }
+}
+async function createProject(args) {
+  const target = resolve(args.dir);
+  if (existsSync(target)) {
+    throw new Error(`mountly-mcp: target directory already exists: ${target}`);
+  }
+  const tplDir = join(TEMPLATES, args.framework);
+  if (!existsSync(tplDir)) {
+    throw new Error(
+      `mountly-mcp: template for framework "${args.framework}" is missing at ${tplDir}`
+    );
+  }
+  mkdirSync(target, { recursive: true });
+  cpSync(tplDir, target, { recursive: true });
+  const slug = slugify(args.name) || "app";
+  renderTemplates(target, {
+    name: args.name,
+    slug,
+    uri: `ui://${slug}/dashboard`,
+    framework: args.framework
+  });
+  process.stdout.write(
+    [
+      "",
+      `\u2713 Created MCP App ${args.name} (${args.framework}) at ${target}`,
+      "",
+      "Next steps:",
+      `  cd ${args.dir}`,
+      "  pnpm install",
+      "  pnpm dev          # sandboxed host + live reload",
+      "  pnpm verify       # conformance check",
+      "",
+      "Do not clone the Mountly monorepo for greenfield apps \u2014 this scaffold is the canonical path.",
+      ""
+    ].join("\n")
+  );
+}
+export {
+  createProject,
+  parseCreateArgs
+};
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/create.ts"],"sourcesContent":["import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  readdirSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n/** Package root: dist/cli.js → .. ; src/cli.ts during tests → .. when run via dist. */\nconst PACKAGE_ROOT = resolve(__dirname, \"..\");\nconst TEMPLATES = resolve(PACKAGE_ROOT, \"templates\");\n\nconst SUPPORTED = [\"react\", \"vue\", \"svelte\"] as const;\ntype Framework = (typeof SUPPORTED)[number];\n\nexport interface CreateArgs {\n  name: string;\n  framework: Framework;\n  dir: string;\n}\n\nexport function parseCreateArgs(argv: ReadonlyArray<string>): CreateArgs {\n  const name = argv[0];\n  if (!name || name.startsWith(\"-\")) {\n    throw new Error(\n      \"mountly-mcp create requires a project name. e.g. mountly-mcp create my-app --framework react\",\n    );\n  }\n\n  let framework: Framework = \"react\";\n  let dir = `./${name}`;\n\n  for (let i = 1; i < argv.length; i += 1) {\n    const arg = argv[i];\n    if (arg === \"--framework\" || arg === \"-f\") {\n      const value = argv[++i];\n      if (value === undefined) throw new Error(`mountly-mcp: ${arg} needs a value`);\n      if (!SUPPORTED.includes(value as Framework)) {\n        throw new Error(\n          `mountly-mcp: framework \"${value}\" not supported. Available: ${SUPPORTED.join(\", \")}`,\n        );\n      }\n      framework = value as Framework;\n    } else if (arg === \"--dir\") {\n      const value = argv[++i];\n      if (value === undefined) throw new Error(\"mountly-mcp: --dir needs a value\");\n      dir = value;\n    } else {\n      throw new Error(`mountly-mcp: unknown create option '${arg}'`);\n    }\n  }\n\n  return { name, framework, dir };\n}\n\nfunction slugify(name: string): string {\n  return name\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\");\n}\n\nfunction renderTemplates(dir: string, ctx: Record<string, string>): void {\n  for (const entry of readdirSync(dir)) {\n    const full = join(dir, entry);\n    if (statSync(full).isDirectory()) {\n      renderTemplates(full, ctx);\n      continue;\n    }\n    if (!entry.endsWith(\".tmpl\")) continue;\n    let content = readFileSync(full, \"utf8\");\n    for (const [key, value] of Object.entries(ctx)) {\n      content = content.split(`{{${key}}}`).join(value);\n    }\n    writeFileSync(full.replace(/\\.tmpl$/, \"\"), content);\n    unlinkSync(full);\n  }\n}\n\nexport async function createProject(args: CreateArgs): Promise<void> {\n  const target = resolve(args.dir);\n  if (existsSync(target)) {\n    throw new Error(`mountly-mcp: target directory already exists: ${target}`);\n  }\n\n  const tplDir = join(TEMPLATES, args.framework);\n  if (!existsSync(tplDir)) {\n    throw new Error(\n      `mountly-mcp: template for framework \"${args.framework}\" is missing at ${tplDir}`,\n    );\n  }\n\n  mkdirSync(target, { recursive: true });\n  cpSync(tplDir, target, { recursive: true });\n\n  const slug = slugify(args.name) || \"app\";\n  renderTemplates(target, {\n    name: args.name,\n    slug,\n    uri: `ui://${slug}/dashboard`,\n    framework: args.framework,\n  });\n\n  process.stdout.write(\n    [\n      \"\",\n      `✓ Created MCP App ${args.name} (${args.framework}) at ${target}`,\n      \"\",\n      \"Next steps:\",\n      `  cd ${args.dir}`,\n      \"  pnpm install\",\n      \"  pnpm dev          # sandboxed host + live reload\",\n      \"  pnpm verify       # conformance check\",\n      \"\",\n      \"Do not clone the Mountly monorepo for greenfield apps — this scaffold is the canonical path.\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/dev/connect-server.d.ts

@@ -0,0 +1,13 @@
+export interface ConnectedMcpServer {
+    callTool: (name: string, args: unknown) => Promise<unknown>;
+    /** The model-visible tool bound to `uri` — the one a host would call. */
+    toolFor(uri: string): Promise<string | undefined>;
+    close(): Promise<void>;
+}
+/**
+ * Connect a server module in-process for a development session.
+ *
+ * The module default-exports either the server or a function returning it: a
+ * `RunningMcpAppServer` from `createMcpAppServer`, or a raw `McpServer`.
+ */
+export declare function connectMcpServer(path: string): Promise<ConnectedMcpServer>;

package/dist/dev/host-entry.d.ts

@@ -0,0 +1,13 @@
+interface DevHostConfig {
+    toolName: string;
+    sandboxOrigin: string;
+    fixtures: Record<string, unknown>;
+    toolInput: Record<string, unknown>;
+    uri: string;
+    hasServer: boolean;
+    sandboxPath: string;
+}
+declare global {
+    var __mountlyMcpDevHost__: DevHostConfig;
+}
+export {};