@scenar/mcp-server 0.2.0

package/src/__tests__/server.test.ts

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest";
+import { mkdtemp, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { createScenarServer } from "../server.js";
+
+async function connectClient(): Promise<Client> {
+  const server = createScenarServer();
+  const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+  const client = new Client({ name: "test-client", version: "0.0.0" });
+  await Promise.all([server.connect(serverTransport), client.connect(clientTransport)]);
+  return client;
+}
+
+describe("Scenar MCP server", () => {
+  it("exposes all expected tools", async () => {
+    const client = await connectClient();
+    const { tools } = await client.listTools();
+    const names = tools.map((t) => t.name).sort();
+    expect(names).toEqual(
+      [
+        "scenar_narrate",
+        "scenar_pack",
+        "scenar_preview_init",
+        "scenar_preview_sync",
+        "scenar_publish",
+        "scenar_render",
+        "scenar_serve",
+        "scenar_stop_serve",
+        "scenar_validate",
+      ].sort(),
+    );
+  });
+
+  it("exposes the registry resources and scenario templates", async () => {
+    const client = await connectClient();
+    const { resources } = await client.listResources();
+    const uris = resources.map((r) => r.uri);
+    expect(uris).toContain("scenar://registry/views");
+    expect(uris).toContain("scenar://registry/report");
+    expect(uris).toContain("scenar://registry/providers");
+
+    const { resourceTemplates } = await client.listResourceTemplates();
+    const templates = resourceTemplates.map((t) => t.uriTemplate);
+    expect(templates).toContain("scenar://scenario/{name}/steps");
+    expect(templates).toContain("scenar://scenario/{name}/manifest");
+  });
+
+  it("validates a scenario via the scenar_validate tool", async () => {
+    const dir = await mkdtemp(join(tmpdir(), "scenar-mcp-"));
+    try {
+      const file = join(dir, "bad.yaml");
+      // Missing required fields → the validator should report errors.
+      await writeFile(file, "kind: Scenario\n", "utf-8");
+
+      const client = await connectClient();
+      const result = (await client.callTool({
+        name: "scenar_validate",
+        arguments: { file },
+      })) as { content: Array<{ type: string; text: string }> };
+
+      const body = result.content.map((c) => c.text).join("\n");
+      expect(body).toContain("Invalid");
+    } finally {
+      await rm(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("reads a registry resource, returning guidance when absent", async () => {
+    const client = await connectClient();
+    const result = await client.readResource({ uri: "scenar://registry/views" });
+    expect(result.contents).toHaveLength(1);
+    // With no .scenar/ in the test cwd, the body should guide the user.
+    const text = String(result.contents[0]!.text);
+    expect(text.length).toBeGreaterThan(0);
+  });
+});

package/src/index.d.ts

@@ -0,0 +1,8 @@
+export { createScenarServer, SERVER_VERSION } from "./server.js";
+/**
+ * Start the Scenar MCP server over stdio (how Cursor and other editors launch
+ * it). Stays alive until the transport closes, then stops any preview servers
+ * started during the session.
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1C"}

package/src/index.js

@@ -0,0 +1,20 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createScenarServer } from "./server.js";
+import { stopAllServers } from "./serve-registry.js";
+export { createScenarServer, SERVER_VERSION } from "./server.js";
+/**
+ * Start the Scenar MCP server over stdio (how Cursor and other editors launch
+ * it). Stays alive until the transport closes, then stops any preview servers
+ * started during the session.
+ */
+export async function main() {
+    const server = createScenarServer();
+    const transport = new StdioServerTransport();
+    const shutdown = () => {
+        void stopAllServers().finally(() => process.exit(0));
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await server.connect(transport);
+}
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,KAAK,cAAc,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC"}

package/src/index.ts

@@ -0,0 +1,23 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createScenarServer } from "./server.js";
+import { stopAllServers } from "./serve-registry.js";
+
+export { createScenarServer, SERVER_VERSION } from "./server.js";
+
+/**
+ * Start the Scenar MCP server over stdio (how Cursor and other editors launch
+ * it). Stays alive until the transport closes, then stops any preview servers
+ * started during the session.
+ */
+export async function main(): Promise<void> {
+  const server = createScenarServer();
+  const transport = new StdioServerTransport();
+
+  const shutdown = () => {
+    void stopAllServers().finally(() => process.exit(0));
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+
+  await server.connect(transport);
+}

package/src/project.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The project root the server reads relative paths against. Cursor launches the
+ * MCP server with its working directory set to the workspace, but an explicit
+ * SCENAR_PROJECT_ROOT always wins (useful for monorepos or non-cwd launches).
+ */
+export declare function projectRoot(): string;
+/** Resolve a possibly-relative path against the project root. */
+export declare function resolveInProject(path: string): string;
+/** Read a project-relative text file, or null if it is missing/unreadable. */
+export declare function readProjectFile(relativePath: string): Promise<string | null>;
+//# sourceMappingURL=project.d.ts.map

package/src/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMlF"}

package/src/project.js

@@ -0,0 +1,24 @@
+import { resolve, isAbsolute, join } from "node:path";
+import { readFile } from "node:fs/promises";
+/**
+ * The project root the server reads relative paths against. Cursor launches the
+ * MCP server with its working directory set to the workspace, but an explicit
+ * SCENAR_PROJECT_ROOT always wins (useful for monorepos or non-cwd launches).
+ */
+export function projectRoot() {
+    return resolve(process.env.SCENAR_PROJECT_ROOT ?? process.cwd());
+}
+/** Resolve a possibly-relative path against the project root. */
+export function resolveInProject(path) {
+    return isAbsolute(path) ? path : join(projectRoot(), path);
+}
+/** Read a project-relative text file, or null if it is missing/unreadable. */
+export async function readProjectFile(relativePath) {
+    try {
+        return await readFile(join(projectRoot(), relativePath), "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=project.js.map

package/src/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,YAAoB;IACxD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/src/project.ts

@@ -0,0 +1,25 @@
+import { resolve, isAbsolute, join } from "node:path";
+import { readFile } from "node:fs/promises";
+
+/**
+ * The project root the server reads relative paths against. Cursor launches the
+ * MCP server with its working directory set to the workspace, but an explicit
+ * SCENAR_PROJECT_ROOT always wins (useful for monorepos or non-cwd launches).
+ */
+export function projectRoot(): string {
+  return resolve(process.env.SCENAR_PROJECT_ROOT ?? process.cwd());
+}
+
+/** Resolve a possibly-relative path against the project root. */
+export function resolveInProject(path: string): string {
+  return isAbsolute(path) ? path : join(projectRoot(), path);
+}
+
+/** Read a project-relative text file, or null if it is missing/unreadable. */
+export async function readProjectFile(relativePath: string): Promise<string | null> {
+  try {
+    return await readFile(join(projectRoot(), relativePath), "utf-8");
+  } catch {
+    return null;
+  }
+}

package/src/resources.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register read-only resources the AI can inspect for authoring context: the
+ * generated view registry + scan report (in .scenar/), and per-scenario steps +
+ * pack manifest. All are read relative to the project root; a missing file
+ * returns a short explanatory body rather than an error so the client degrades
+ * gracefully.
+ */
+export declare function registerResources(server: McpServer): void;
+//# sourceMappingURL=resources.d.ts.map

package/src/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAGtF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+EzD"}

package/src/resources.js

@@ -0,0 +1,81 @@
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { projectRoot, readProjectFile } from "./project.js";
+/**
+ * Register read-only resources the AI can inspect for authoring context: the
+ * generated view registry + scan report (in .scenar/), and per-scenario steps +
+ * pack manifest. All are read relative to the project root; a missing file
+ * returns a short explanatory body rather than an error so the client degrades
+ * gracefully.
+ */
+export function registerResources(server) {
+    registerRegistryFile(server, "scenar-views", "scenar://registry/views", "Scenar view registry", "The generated .scenar/views.ts — the components available to scenarios.", ".scenar/views.ts", "text/plain");
+    registerRegistryFile(server, "scenar-report", "scenar://registry/report", "Scenar scan report", "The .scenar/report.md — what the scanner discovered, skipped, and why.", ".scenar/report.md", "text/markdown");
+    registerRegistryFile(server, "scenar-providers", "scenar://registry/providers", "Scenar provider wiring", "The .scenar/providers.tsx — how real components are wrapped for preview.", ".scenar/providers.tsx", "text/plain");
+    // Per-scenario resources: {name} is a scenario directory under the project.
+    server.registerResource("scenar-scenario-steps", new ResourceTemplate("scenar://scenario/{name}/steps", { list: undefined }), {
+        title: "Scenario steps",
+        description: "The steps.ts of a named scenario directory under the project root.",
+    }, async (uri, variables) => {
+        const name = String(variables.name);
+        const body = await readFirstExisting([
+            join(projectRoot(), name, "steps.ts"),
+            join(projectRoot(), name, "steps.tsx"),
+        ]);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/plain",
+                    text: body ?? `No steps.ts found for scenario "${name}" under ${projectRoot()}.`,
+                },
+            ],
+        };
+    });
+    server.registerResource("scenar-scenario-manifest", new ResourceTemplate("scenar://scenario/{name}/manifest", { list: undefined }), {
+        title: "Scenario pack manifest",
+        description: "The pack-manifest.json of a named scenario's packed bundle (<name>-bundle/).",
+    }, async (uri, variables) => {
+        const name = String(variables.name);
+        const body = await readFirstExisting([
+            join(projectRoot(), `${name}-bundle`, "pack-manifest.json"),
+            join(projectRoot(), name, "pack-manifest.json"),
+        ]);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "application/json",
+                    text: body ?? `No pack-manifest.json found for "${name}". Run scenar_pack first.`,
+                },
+            ],
+        };
+    });
+}
+function registerRegistryFile(server, id, uri, title, description, relativePath, mimeType) {
+    server.registerResource(id, uri, { title, description, mimeType }, async (u) => {
+        const body = await readProjectFile(relativePath);
+        return {
+            contents: [
+                {
+                    uri: u.href,
+                    mimeType,
+                    text: body ?? `No ${relativePath} yet. Run scenar_preview_init to generate it.`,
+                },
+            ],
+        };
+    });
+}
+async function readFirstExisting(paths) {
+    for (const path of paths) {
+        try {
+            return await readFile(path, "utf-8");
+        }
+        catch {
+            // try next
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=resources.js.map

package/src/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAa,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,oBAAoB,CAClB,MAAM,EACN,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,yEAAyE,EACzE,kBAAkB,EAClB,YAAY,CACb,CAAC;IACF,oBAAoB,CAClB,MAAM,EACN,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,EACpB,wEAAwE,EACxE,mBAAmB,EACnB,eAAe,CAChB,CAAC;IACF,oBAAoB,CAClB,MAAM,EACN,kBAAkB,EAClB,6BAA6B,EAC7B,wBAAwB,EACxB,0EAA0E,EAC1E,uBAAuB,EACvB,YAAY,CACb,CAAC;IAEF,4EAA4E;IAC5E,MAAM,CAAC,gBAAgB,CACrB,uBAAuB,EACvB,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC3E;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,oEAAoE;KAClF,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC;YACrC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC;SACvC,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,IAAI,IAAI,mCAAmC,IAAI,WAAW,WAAW,EAAE,GAAG;iBACjF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,0BAA0B,EAC1B,IAAI,gBAAgB,CAAC,mCAAmC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC9E;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,8EAA8E;KAC5F,EACD,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;YACnC,IAAI,CAAC,WAAW,EAAE,EAAE,GAAG,IAAI,SAAS,EAAE,oBAAoB,CAAC;YAC3D,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,oBAAoB,CAAC;SAChD,CAAC,CAAC;QACH,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,IAAI,oCAAoC,IAAI,2BAA2B;iBAClF;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,MAAiB,EACjB,EAAU,EACV,GAAW,EACX,KAAa,EACb,WAAmB,EACnB,YAAoB,EACpB,QAAgB;IAEhB,MAAM,CAAC,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7E,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,CAAC,CAAC,IAAI;oBACX,QAAQ;oBACR,IAAI,EAAE,IAAI,IAAI,MAAM,YAAY,+CAA+C;iBAChF;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,KAAe;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/src/resources.ts

@@ -0,0 +1,126 @@
+import { join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { projectRoot, readProjectFile } from "./project.js";
+
+/**
+ * Register read-only resources the AI can inspect for authoring context: the
+ * generated view registry + scan report (in .scenar/), and per-scenario steps +
+ * pack manifest. All are read relative to the project root; a missing file
+ * returns a short explanatory body rather than an error so the client degrades
+ * gracefully.
+ */
+export function registerResources(server: McpServer): void {
+  registerRegistryFile(
+    server,
+    "scenar-views",
+    "scenar://registry/views",
+    "Scenar view registry",
+    "The generated .scenar/views.ts — the components available to scenarios.",
+    ".scenar/views.ts",
+    "text/plain",
+  );
+  registerRegistryFile(
+    server,
+    "scenar-report",
+    "scenar://registry/report",
+    "Scenar scan report",
+    "The .scenar/report.md — what the scanner discovered, skipped, and why.",
+    ".scenar/report.md",
+    "text/markdown",
+  );
+  registerRegistryFile(
+    server,
+    "scenar-providers",
+    "scenar://registry/providers",
+    "Scenar provider wiring",
+    "The .scenar/providers.tsx — how real components are wrapped for preview.",
+    ".scenar/providers.tsx",
+    "text/plain",
+  );
+
+  // Per-scenario resources: {name} is a scenario directory under the project.
+  server.registerResource(
+    "scenar-scenario-steps",
+    new ResourceTemplate("scenar://scenario/{name}/steps", { list: undefined }),
+    {
+      title: "Scenario steps",
+      description: "The steps.ts of a named scenario directory under the project root.",
+    },
+    async (uri, variables) => {
+      const name = String(variables.name);
+      const body = await readFirstExisting([
+        join(projectRoot(), name, "steps.ts"),
+        join(projectRoot(), name, "steps.tsx"),
+      ]);
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: "text/plain",
+            text: body ?? `No steps.ts found for scenario "${name}" under ${projectRoot()}.`,
+          },
+        ],
+      };
+    },
+  );
+
+  server.registerResource(
+    "scenar-scenario-manifest",
+    new ResourceTemplate("scenar://scenario/{name}/manifest", { list: undefined }),
+    {
+      title: "Scenario pack manifest",
+      description: "The pack-manifest.json of a named scenario's packed bundle (<name>-bundle/).",
+    },
+    async (uri, variables) => {
+      const name = String(variables.name);
+      const body = await readFirstExisting([
+        join(projectRoot(), `${name}-bundle`, "pack-manifest.json"),
+        join(projectRoot(), name, "pack-manifest.json"),
+      ]);
+      return {
+        contents: [
+          {
+            uri: uri.href,
+            mimeType: "application/json",
+            text: body ?? `No pack-manifest.json found for "${name}". Run scenar_pack first.`,
+          },
+        ],
+      };
+    },
+  );
+}
+
+function registerRegistryFile(
+  server: McpServer,
+  id: string,
+  uri: string,
+  title: string,
+  description: string,
+  relativePath: string,
+  mimeType: string,
+): void {
+  server.registerResource(id, uri, { title, description, mimeType }, async (u) => {
+    const body = await readProjectFile(relativePath);
+    return {
+      contents: [
+        {
+          uri: u.href,
+          mimeType,
+          text: body ?? `No ${relativePath} yet. Run scenar_preview_init to generate it.`,
+        },
+      ],
+    };
+  });
+}
+
+async function readFirstExisting(paths: string[]): Promise<string | null> {
+  for (const path of paths) {
+    try {
+      return await readFile(path, "utf-8");
+    } catch {
+      // try next
+    }
+  }
+  return null;
+}

package/src/serve-registry.d.ts

@@ -0,0 +1,8 @@
+import type { BundleServerHandle } from "@scenar/cli/api";
+export declare function rememberServer(handle: BundleServerHandle): void;
+export declare function listServers(): string[];
+/** Stop a server by URL. Returns true if one was running and is now stopped. */
+export declare function stopServer(url: string): Promise<boolean>;
+/** Stop every running server (called on process shutdown). */
+export declare function stopAllServers(): Promise<void>;
+//# sourceMappingURL=serve-registry.d.ts.map

package/src/serve-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-registry.d.ts","sourceRoot":"","sources":["../../src/serve-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAU1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAE/D;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,gFAAgF;AAChF,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM9D;AAED,8DAA8D;AAC9D,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD"}

package/src/serve-registry.js

@@ -0,0 +1,29 @@
+/**
+ * Tracks preview servers started by the `scenar_serve` tool so they outlive a
+ * single tool call (the AI starts one, then keeps working) and can be listed or
+ * stopped. Keyed by the served URL. The server process owns these; they are all
+ * closed on shutdown.
+ */
+const servers = new Map();
+export function rememberServer(handle) {
+    servers.set(handle.url, handle);
+}
+export function listServers() {
+    return [...servers.keys()];
+}
+/** Stop a server by URL. Returns true if one was running and is now stopped. */
+export async function stopServer(url) {
+    const handle = servers.get(url);
+    if (!handle)
+        return false;
+    await handle.close();
+    servers.delete(url);
+    return true;
+}
+/** Stop every running server (called on process shutdown). */
+export async function stopAllServers() {
+    const handles = [...servers.values()];
+    servers.clear();
+    await Promise.all(handles.map((h) => h.close().catch(() => { })));
+}
+//# sourceMappingURL=serve-registry.js.map

package/src/serve-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-registry.js","sourceRoot":"","sources":["../../src/serve-registry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEtD,MAAM,UAAU,cAAc,CAAC,MAA0B;IACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/src/serve-registry.ts

@@ -0,0 +1,33 @@
+import type { BundleServerHandle } from "@scenar/cli/api";
+
+/**
+ * Tracks preview servers started by the `scenar_serve` tool so they outlive a
+ * single tool call (the AI starts one, then keeps working) and can be listed or
+ * stopped. Keyed by the served URL. The server process owns these; they are all
+ * closed on shutdown.
+ */
+const servers = new Map<string, BundleServerHandle>();
+
+export function rememberServer(handle: BundleServerHandle): void {
+  servers.set(handle.url, handle);
+}
+
+export function listServers(): string[] {
+  return [...servers.keys()];
+}
+
+/** Stop a server by URL. Returns true if one was running and is now stopped. */
+export async function stopServer(url: string): Promise<boolean> {
+  const handle = servers.get(url);
+  if (!handle) return false;
+  await handle.close();
+  servers.delete(url);
+  return true;
+}
+
+/** Stop every running server (called on process shutdown). */
+export async function stopAllServers(): Promise<void> {
+  const handles = [...servers.values()];
+  servers.clear();
+  await Promise.all(handles.map((h) => h.close().catch(() => {})));
+}

package/src/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** The server's advertised version (kept in step with the package). */
+export declare const SERVER_VERSION = "0.0.1";
+/**
+ * Build a fully-configured Scenar MCP server (tools + resources registered),
+ * ready to connect to a transport. Factored out so tests can construct it
+ * without standing up stdio.
+ */
+export declare function createScenarServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,uEAAuE;AACvE,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,CAU9C"}

package/src/server.js

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+/** The server's advertised version (kept in step with the package). */
+export const SERVER_VERSION = "0.0.1";
+/**
+ * Build a fully-configured Scenar MCP server (tools + resources registered),
+ * ready to connect to a transport. Factored out so tests can construct it
+ * without standing up stdio.
+ */
+export function createScenarServer() {
+    const server = new McpServer({
+        name: "scenar",
+        version: SERVER_VERSION,
+    });
+    registerTools(server);
+    registerResources(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,CAAC,CAAC;IACtB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/src/server.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+
+/** The server's advertised version (kept in step with the package). */
+export const SERVER_VERSION = "0.0.1";
+
+/**
+ * Build a fully-configured Scenar MCP server (tools + resources registered),
+ * ready to connect to a transport. Factored out so tests can construct it
+ * without standing up stdio.
+ */
+export function createScenarServer(): McpServer {
+  const server = new McpServer({
+    name: "scenar",
+    version: SERVER_VERSION,
+  });
+
+  registerTools(server);
+  registerResources(server);
+
+  return server;
+}

package/src/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Register every Scenar tool on the server. */
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/src/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAUrD"}