@openpresentation/mcp 0.0.1 → 0.29.0

package/dist/chunk-MX4ICVMM.js

@@ -0,0 +1,33 @@
+import {
+  createOpfServer
+} from "./chunk-4FQTU7KN.js";
+
+// src/stdio.ts
+import { createRequire } from "module";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { Reporter, measuringFonts, readDeckReport } from "@openpresentation/opf/internal/engine";
+async function checkDeckText(raw, format, options) {
+  const measuring = await measuringFonts(readDeckReport(raw, { format, validate: false }).presentation, { reporter: new Reporter(), flags: true });
+  try {
+    const { presentation: _deck, format: _format, ...report } = readDeckReport(raw, { format, validate: measuring.fonts ? { ...options, fonts: measuring.fonts } : options });
+    if (measuring.estimated && report.checks.layout === "estimated") {
+      const named = measuring.estimated.details?.package ?? "@openpresentation/opf-render";
+      return { ...report, hint: `Layout was estimated: ${named} is not installed, so text was measured with core's portable estimate rather than the fonts opf convert draws with. To measure it, install it: npm install ${named}` };
+    }
+    return report;
+  } finally {
+    measuring.release();
+  }
+}
+async function runStdio(host = {}) {
+  const opfVersion = host.opfVersion ?? createRequire(import.meta.url)("@openpresentation/opf/package.json").version;
+  const server = createOpfServer({ version: host.version ?? "0.29.0", opfVersion, checkText: checkDeckText });
+  process.stdin.once("close", () => void server.close());
+  await server.connect(new StdioServerTransport());
+}
+
+export {
+  checkDeckText,
+  runStdio
+};
+//# sourceMappingURL=chunk-MX4ICVMM.js.map

package/dist/chunk-MX4ICVMM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stdio.ts"],"sourcesContent":["// `opf-mcp`: the OPF MCP server over stdio. A thin wrapper: the server definition is ./server.ts; this adds the transport and, because\n// it runs under Node, the measured layout check `opf validate` makes (the fonts of @openpresentation/opf-render when it is installed;\n// otherwise core's estimate, and the report's hint says so). Stdout carries the protocol and nothing else; diagnostics go to stderr.\nimport { createRequire } from \"node:module\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport type { ValidateOptions, ValidationReport } from \"@openpresentation/opf\";\nimport { Reporter, measuringFonts, readDeckReport } from \"@openpresentation/opf/internal/engine\";\nimport { type DeckFormat, createOpfServer } from \"./index.js\";\n\ndeclare const MCP_VERSION: string;\n\n/** The versions the server reports: this package's, and the core it runs on. */\nexport interface StdioHost {\n\tversion?: string;\n\topfVersion?: string;\n}\n\n/** Deck text checked as `opf validate` checks it: layout measured with the fonts `opf convert` draws with when opf-render is installed. */\nexport async function checkDeckText(raw: string, format: DeckFormat, options: ValidateOptions): Promise<ValidationReport> {\n\tconst measuring = await measuringFonts(readDeckReport(raw, { format, validate: false }).presentation, { reporter: new Reporter(), flags: true });\n\ttry {\n\t\tconst { presentation: _deck, format: _format, ...report } = readDeckReport(raw, { format, validate: measuring.fonts ? { ...options, fonts: measuring.fonts } : options });\n\t\tif (measuring.estimated && report.checks.layout === \"estimated\") {\n\t\t\tconst named = (measuring.estimated.details as { package?: string } | undefined)?.package ?? \"@openpresentation/opf-render\";\n\t\t\treturn { ...report, hint: `Layout was estimated: ${named} is not installed, so text was measured with core's portable estimate rather than the fonts opf convert draws with. To measure it, install it: npm install ${named}` } as ValidationReport;\n\t\t}\n\t\treturn report;\n\t} finally {\n\t\tmeasuring.release();\n\t}\n}\n\n/** Serve MCP on stdin and stdout until the client closes stdin. */\nexport async function runStdio(host: StdioHost = {}): Promise<void> {\n\tconst opfVersion = host.opfVersion ?? (createRequire(import.meta.url)(\"@openpresentation/opf/package.json\") as { version: string }).version;\n\tconst server = createOpfServer({ version: host.version ?? MCP_VERSION, opfVersion, checkText: checkDeckText });\n\t// The client closing stdin ends the session; with nothing left open the process exits on its own.\n\tprocess.stdin.once(\"close\", () => void server.close());\n\tawait server.connect(new StdioServerTransport());\n}\n"],"mappings":";;;;;AAGA,SAAS,qBAAqB;AAC9B,SAAS,4BAA4B;AAErC,SAAS,UAAU,gBAAgB,sBAAsB;AAYzD,eAAsB,cAAc,KAAa,QAAoB,SAAqD;AACzH,QAAM,YAAY,MAAM,eAAe,eAAe,KAAK,EAAE,QAAQ,UAAU,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,IAAI,SAAS,GAAG,OAAO,KAAK,CAAC;AAC/I,MAAI;AACH,UAAM,EAAE,cAAc,OAAO,QAAQ,SAAS,GAAG,OAAO,IAAI,eAAe,KAAK,EAAE,QAAQ,UAAU,UAAU,QAAQ,EAAE,GAAG,SAAS,OAAO,UAAU,MAAM,IAAI,QAAQ,CAAC;AACxK,QAAI,UAAU,aAAa,OAAO,OAAO,WAAW,aAAa;AAChE,YAAM,QAAS,UAAU,UAAU,SAA8C,WAAW;AAC5F,aAAO,EAAE,GAAG,QAAQ,MAAM,yBAAyB,KAAK,8JAA8J,KAAK,GAAG;AAAA,IAC/N;AACA,WAAO;AAAA,EACR,UAAE;AACD,cAAU,QAAQ;AAAA,EACnB;AACD;AAGA,eAAsB,SAAS,OAAkB,CAAC,GAAkB;AACnE,QAAM,aAAa,KAAK,cAAe,cAAc,YAAY,GAAG,EAAE,oCAAoC,EAA0B;AACpI,QAAM,SAAS,gBAAgB,EAAE,SAAS,KAAK,WAAW,UAAa,YAAY,WAAW,cAAc,CAAC;AAE7G,UAAQ,MAAM,KAAK,SAAS,MAAM,KAAK,OAAO,MAAM,CAAC;AACrD,QAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;AAChD;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { OpfMcpSources, OpfMcpOptions } from './server.js';
+export { CheckText, DeckFormat, DocPage, ExamplePage, McpToolError, ResolvedSchema, createOpfMcpServer, resolveSchema } from './server.js';
+import '@openpresentation/opf';
+
+/**
+ * The documentation pages for people and agents who use OPF, by slug. Core bundles every top-level page of docs/; this list leaves
+ * out what is for the maintainers: handoffs, evidence, status and backlog notes, security and release runbooks, the compatibility
+ * matrix. A new page is listed here on purpose (the test checks every slug exists and that no dated or handoff page is listed).
+ */
+declare const DOC_SLUGS: readonly string[];
+/** The bundled sources. Pass `{ ...defaultSources(), examples: [] }` to a host that must stay small. */
+declare function defaultSources(): OpfMcpSources;
+
+/** The server with the bundled docs, examples, skills and release notes (`sources` replaces any of them, for a host that must stay small). */
+declare function createOpfServer(options: Omit<OpfMcpOptions, "sources"> & {
+    sources?: Partial<OpfMcpOptions["sources"]>;
+}): McpServer;
+
+export { DOC_SLUGS, OpfMcpOptions, OpfMcpSources, createOpfServer, defaultSources };

package/dist/index.js

@@ -0,0 +1,19 @@
+import {
+  DOC_SLUGS,
+  createOpfServer,
+  defaultSources
+} from "./chunk-4FQTU7KN.js";
+import {
+  McpToolError,
+  createOpfMcpServer,
+  resolveSchema
+} from "./chunk-7STOTAET.js";
+export {
+  DOC_SLUGS,
+  McpToolError,
+  createOpfMcpServer,
+  createOpfServer,
+  defaultSources,
+  resolveSchema
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,58 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ValidateOptions, ValidationReport } from '@openpresentation/opf';
+
+type DeckFormat = "json" | "yaml" | "markdown";
+/** A documentation page: its slug (the file name without `.md`), its first heading and its Markdown. */
+interface DocPage {
+    slug: string;
+    title: string;
+    markdown: string;
+}
+/** An example deck: its slug (the file name without `.opf.json`), its folder under examples/ and the deck. */
+interface ExamplePage {
+    slug: string;
+    category: string;
+    gallery?: string | null;
+    file: string;
+    deck: unknown;
+}
+/** The data the server serves. `skills` maps a skill name to its files (`SKILL.md`, `references/...`), path to text. */
+interface OpfMcpSources {
+    docs: readonly DocPage[];
+    examples: readonly ExamplePage[];
+    skills: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** The recent release notes, as text: `opf://docs/whats-new`. Left out when absent. */
+    whatsNew?: string;
+}
+/** Checks deck text as `opf validate` does and returns the report. The default is edge-safe (layout estimated); `opf mcp` supplies the measured one. */
+type CheckText = (raw: string, format: DeckFormat, options: ValidateOptions) => Promise<ValidationReport> | ValidationReport;
+interface OpfMcpOptions {
+    /** The version the server reports (the CLI's). */
+    version: string;
+    /** The version of core the checks run on. */
+    opfVersion?: string;
+    sources: OpfMcpSources;
+    checkText?: CheckText;
+}
+/** A failure the tools report as `{ ok: false, code, error, ... }` with `isError`. */
+declare class McpToolError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(message: string, code: string, details?: Record<string, unknown>);
+}
+interface ResolvedSchema {
+    name: string;
+    pointer: string;
+    id?: string;
+    schema: unknown;
+}
+/**
+ * A schema, or the part of one. `name` is a schema (`opf schemas` lists them) or a `$defs` name (`Chart`, found in the presentation
+ * schema first); `pointer` is a JSON Pointer into the schema, or a `$defs` name. Like `opf schema`, `$ref`s are left as written.
+ */
+declare function resolveSchema(name?: string, pointer?: string, opfVersion?: string): ResolvedSchema;
+/** Build the server. Connect it to a transport (`server.connect(...)`): stdio for `opf mcp`, Streamable HTTP for a hosted one. */
+declare function createOpfMcpServer(options: OpfMcpOptions): McpServer;
+
+export { McpToolError, createOpfMcpServer, resolveSchema };
+export type { CheckText, DeckFormat, DocPage, ExamplePage, OpfMcpOptions, OpfMcpSources, ResolvedSchema };

package/dist/server.js

@@ -0,0 +1,11 @@
+import {
+  McpToolError,
+  createOpfMcpServer,
+  resolveSchema
+} from "./chunk-7STOTAET.js";
+export {
+  McpToolError,
+  createOpfMcpServer,
+  resolveSchema
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/stdio.d.ts

@@ -0,0 +1,16 @@
+import { ValidateOptions, ValidationReport } from '@openpresentation/opf';
+import { DeckFormat } from './server.js';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+
+/** The versions the server reports: this package's, and the core it runs on. */
+interface StdioHost {
+    version?: string;
+    opfVersion?: string;
+}
+/** Deck text checked as `opf validate` checks it: layout measured with the fonts `opf convert` draws with when opf-render is installed. */
+declare function checkDeckText(raw: string, format: DeckFormat, options: ValidateOptions): Promise<ValidationReport>;
+/** Serve MCP on stdin and stdout until the client closes stdin. */
+declare function runStdio(host?: StdioHost): Promise<void>;
+
+export { checkDeckText, runStdio };
+export type { StdioHost };

package/dist/stdio.js

@@ -0,0 +1,11 @@
+import {
+  checkDeckText,
+  runStdio
+} from "./chunk-MX4ICVMM.js";
+import "./chunk-4FQTU7KN.js";
+import "./chunk-7STOTAET.js";
+export {
+  checkDeckText,
+  runStdio
+};
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

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

package/package.json

@@ -1,8 +1,86 @@
 {
   "name": "@openpresentation/mcp",
-  "version": "0.0.1",
-  "description": "Placeholder: the OPF MCP server is published from OpenPresentation/opf by its release workflow.",
+  "version": "0.29.0",
+  "description": "An MCP server for OPF: learn the format (docs, schemas, the default catalog, examples and agent skills as resources and tools), validate and convert decks. Runs locally on stdio (opf-mcp) or hosted on an edge runtime.",
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/OpenPresentation/opf.git", "directory": "packages/mcp" },
-  "publishConfig": { "access": "public" }
+  "author": "Open Presentation",
+  "homepage": "https://github.com/OpenPresentation/opf/blob/main/docs/mcp.md",
+  "keywords": [
+    "opf",
+    "open-presentation-format",
+    "mcp",
+    "model-context-protocol",
+    "presentation",
+    "agents"
+  ],
+  "type": "module",
+  "bin": {
+    "opf-mcp": "./dist/bin.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "default": "./dist/server.js"
+    },
+    "./stdio": {
+      "types": "./dist/stdio.d.ts",
+      "default": "./dist/stdio.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.32.2",
+    "zod": "4.6.7",
+    "@openpresentation/opf": "^0.29.0",
+    "@openpresentation/gallery": "^0.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.4",
+    "tsup": "^9.0.0",
+    "typescript": "~5.9.3",
+    "workerd": "1.20261023.1",
+    "@openpresentation/cli": "0.29.0",
+    "@openpresentation/opf-render": "0.29.0"
+  },
+  "peerDependencies": {
+    "@openpresentation/opf-render": "^0.29.0"
+  },
+  "peerDependenciesMeta": {
+    "@openpresentation/opf-render": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OpenPresentation/opf.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/OpenPresentation/opf/issues"
+  },
+  "scripts": {
+    "build:deps": "pnpm --filter \"@openpresentation/mcp^...\" --fail-if-no-match run build",
+    "build": "node ../../scripts/reuse-build.mjs check || (tsup && node ../../scripts/reuse-build.mjs stamp)",
+    "typecheck": "pnpm run build:deps && node ../../scripts/typecheck.mjs --noEmit",
+    "clean": "rm -rf dist",
+    "test": "pnpm run build:deps && pnpm run build && node ../../scripts/run-tests.mjs"
+  },
+  "gitHead": "464e10d3c15647b0e43326ac7e6761e34789991a"
 }