@openpresentation/mcp 0.0.1 → 0.28.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Data-Advantage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,33 @@
-Placeholder. See https://github.com/OpenPresentation/opf/blob/main/docs/mcp.md
+# @openpresentation/mcp
+
+The MCP server for OPF (Open Presentation Format). An agent or editor that speaks the [Model Context Protocol](https://modelcontextprotocol.io)
+learns the format and checks decks through it, without shelling out and parsing text: documentation, schemas, the default catalog,
+example decks and the six agent skills as resources, a `start_here` tool that gives a path for a goal, and `validate_deck`,
+`get_schema`, `search_catalog`, `get_catalog_record`, `convert`, `search_docs` and `list_examples` as tools. It keeps no state, reads
+no file, fetches nothing, and needs no API key. Node 22 or later.
+
+```sh
+claude mcp add opf -- npx -y @openpresentation/mcp          # Claude Code
+npx -y @openpresentation/mcp                                  # any MCP client: command npx, args -y @openpresentation/mcp
+```
+
+Tools, resources (`opf://docs/format-card`, `opf://schema/presentation#Chart`, `opf://catalog/layouts/two-column`, ...), prompts, client
+setup (Claude Code, Cursor, Claude Desktop) and a typical session: [the MCP server](https://github.com/OpenPresentation/opf/blob/main/docs/mcp.md).
+
+## As a library
+
+The server definition is separate from the transport and runs on an edge runtime (no Node builtin, no file read, precompiled
+validators), for a hosted server:
+
+```ts
+import { createOpfServer } from "@openpresentation/mcp";           // with the bundled docs, examples, skills and release notes
+import { createOpfMcpServer } from "@openpresentation/mcp/server"; // the same without that data: you pass `sources`
+
+const server = createOpfServer({ version: "0.27.0" });
+await server.connect(transport); // stdio, or Streamable HTTP in a Worker
+```
+
+`@openpresentation/mcp/stdio` is the Node stdio wrapper (`runStdio()`) that the `opf-mcp` binary and `opf mcp` of the CLI run. Layout
+is measured with the real fonts when the optional peer `@openpresentation/opf-render` is installed beside it; otherwise it is estimated
+and the report says so. The package is released with `@openpresentation/opf` and the other packages of
+[OpenPresentation/opf](https://github.com/OpenPresentation/opf) at one version.

package/dist/bin.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import {
+  runStdio
+} from "./chunk-PJIH6M4A.js";
+import "./chunk-XMKPAODJ.js";
+import "./chunk-7STOTAET.js";
+
+// src/bin.ts
+var arg = process.argv[2];
+if (arg === "--help" || arg === "-h") {
+  process.stdout.write(`opf-mcp ${"0.28.0"}: the OPF MCP server on stdio.
+
+Usage:
+  npx -y @openpresentation/mcp       run the server (an MCP client starts it: command npx, args -y @openpresentation/mcp)
+  opf-mcp --version
+
+Tools: start_here, validate_deck, get_schema, search_catalog, get_catalog_record, convert, search_docs, list_examples.
+Resources: opf://docs/<slug> (opf://docs/index lists them, opf://docs/whats-new), opf://schema/<name>[#<pointer or $defs name>],
+opf://examples/<slug>, opf://catalog/<kind>/<id>, opf://skills/<name>. Prompts: learn_opf, author_deck, fix_validation_findings,
+choose_layout. It keeps no state and reads no file. Claude Code: claude mcp add opf -- npx -y @openpresentation/mcp
+`);
+} else if (arg === "--version" || arg === "-v") {
+  process.stdout.write(`${"0.28.0"}
+`);
+} else if (arg !== void 0) {
+  process.stderr.write(`opf-mcp takes no arguments (got ${arg}). Run opf-mcp --help.
+`);
+  process.exitCode = 2;
+} else {
+  runStdio().catch((error) => {
+    process.stderr.write(`opf-mcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    process.exitCode = 1;
+  });
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n// `opf-mcp` (and `npx -y @openpresentation/mcp`): the OPF MCP server on stdio. See docs/mcp.md.\nimport { runStdio } from \"./stdio.js\";\n\ndeclare const MCP_VERSION: string;\n\nconst arg = process.argv[2];\nif (arg === \"--help\" || arg === \"-h\") {\n\tprocess.stdout.write(`opf-mcp ${MCP_VERSION}: the OPF MCP server on stdio.\n\nUsage:\n  npx -y @openpresentation/mcp       run the server (an MCP client starts it: command npx, args -y @openpresentation/mcp)\n  opf-mcp --version\n\nTools: start_here, validate_deck, get_schema, search_catalog, get_catalog_record, convert, search_docs, list_examples.\nResources: opf://docs/<slug> (opf://docs/index lists them, opf://docs/whats-new), opf://schema/<name>[#<pointer or $defs name>],\nopf://examples/<slug>, opf://catalog/<kind>/<id>, opf://skills/<name>. Prompts: learn_opf, author_deck, fix_validation_findings,\nchoose_layout. It keeps no state and reads no file. Claude Code: claude mcp add opf -- npx -y @openpresentation/mcp\n`);\n} else if (arg === \"--version\" || arg === \"-v\") {\n\tprocess.stdout.write(`${MCP_VERSION}\\n`);\n} else if (arg !== undefined) {\n\tprocess.stderr.write(`opf-mcp takes no arguments (got ${arg}). Run opf-mcp --help.\\n`);\n\tprocess.exitCode = 2;\n} else {\n\trunStdio().catch((error: unknown) => {\n\t\tprocess.stderr.write(`opf-mcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n\t\tprocess.exitCode = 1;\n\t});\n}\n"],"mappings":";;;;;;;;AAMA,IAAM,MAAM,QAAQ,KAAK,CAAC;AAC1B,IAAI,QAAQ,YAAY,QAAQ,MAAM;AACrC,UAAQ,OAAO,MAAM,WAAW,QAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAU3C;AACD,WAAW,QAAQ,eAAe,QAAQ,MAAM;AAC/C,UAAQ,OAAO,MAAM,GAAG,QAAW;AAAA,CAAI;AACxC,WAAW,QAAQ,QAAW;AAC7B,UAAQ,OAAO,MAAM,mCAAmC,GAAG;AAAA,CAA0B;AACrF,UAAQ,WAAW;AACpB,OAAO;AACN,WAAS,EAAE,MAAM,CAAC,UAAmB;AACpC,YAAQ,OAAO,MAAM,YAAY,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA,CAAI;AAC3F,YAAQ,WAAW;AAAA,EACpB,CAAC;AACF;","names":[]}