document-mcp 1.1.5 → 1.1.7

package/README.md

@@ -4,7 +4,7 @@
 
 > An MCP (Model Context Protocol) server exposing [`documents.js`](https://github.com/ExaDev/documents.js)'s document-conversion, `.odb`, metadata, and font tooling as MCP tools, so an MCP-speaking agent can convert, inspect, and edit docx/pptx/odt/odp/ods/odg/odf/pdf/odb/xlsx/markdown documents without writing TypeScript against `documents.js` directly.
 
-`document-mcp` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, and `.odb`/PDF readers, wired up as MCP tools served over stdio. [`document-cli`](https://github.com/ExaDev/document-cli) is the sibling frontend over the identical `documents.js` library — a terminal CLI/TUI rather than an MCP server — so the two are independent consumers of one shared implementation and can expose different subsets of it.
+`document-mcp` adds no conversion or editing logic of its own — it is a dispatch layer over `documents.js`'s existing conversion functions, `DocumentConverter` port, and `.odb`/PDF readers, wired up as MCP tools served over stdio. [`document-cli`](https://github.com/ExaDev/document-cli) is the sibling frontend over the identical `documents.js` library — a terminal CLI/TUI rather than an MCP server — so the two are independent consumers of one shared implementation and can expose different subsets of it. A `convert_document` call's fidelity — which `(source, targetFormat)` pairs round-trip losslessly, which are a best-effort reconstruction, and why — is exactly what [`documents.js`'s own Fidelity section](https://github.com/ExaDev/documents.js#fidelity) documents, table included; it is not restated here.
 
 ```mermaid
 graph TD
@@ -29,6 +29,8 @@ graph TD
     documents --> mcp
     pdfcodec --> mcp
     documents --> cli
+    odf --> cli
+    pdfcodec --> cli
 
     click schema "https://github.com/ExaDev/document-schema.js" "document-schema.js"
     click ooxml "https://github.com/ExaDev/ooxml.js" "ooxml.js"
@@ -100,7 +102,7 @@ Every tool that takes or produces document bytes goes through the same two hybri
 | `convert_document` | Converts a document from one supported format to another via `documents.js`'s `DocumentConverter` port — docx, pptx, xlsx, odt, odp, ods, odg, odf, markdown, and pdf. Not every `(source, targetFormat)` pair is direct; call `list_document_conversions` first. |
 | `list_document_conversions` | Lists every `(source, target)` format pair `convert_document` actually supports. |
 | `metadata_read` | Reads a document's title/author/subject/keywords/creator/producer/created-and-modified timestamps. Works across every supported format, including xlsx and odf. |
-| `metadata_write` | Patches a document's title/author/subject/keywords in place. Does not convert format — source and target format must match (or both be `pdf`); xlsx and odf are rejected as either. |
+| `metadata_write` | Patches a document's title/author/subject/keywords in place. Does not convert format — source and target format must match (or both be `pdf`); odf (a standalone formula document) is rejected as either, since it has no write path back out at all. |
 | `fonts` | Lists every source-embedded font face a docx/pptx/odt/odp/ods/odg document carries (family, weight/style, byte length). |
 | `describe_font_file` | Reads a standalone `.ttf`/`.otf` font file and reports the family/bold/italic triple it declares about itself. |
 | `docx_extras` | Reads a docx's own comments, footnotes, headers, footers, and numbering definitions — data the `ContentDocument` pivot cannot carry, so no other tool sees it. |

package/dist/bin.js

@@ -8,7 +8,7 @@ import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.1.5";
+var version = "1.1.7";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -372,7 +372,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/dist/index.cjs

@@ -7,7 +7,7 @@ let pdf_codec = require("pdf-codec");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
 //#region package.json
-var version = "1.1.5";
+var version = "1.1.7";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -371,7 +371,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: zod.z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: documents_js.DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/dist/index.js

@@ -6,7 +6,7 @@ import { readFontFace } from "pdf-codec";
 import { existsSync, readFileSync } from "node:fs";
 import { basename, join } from "node:path";
 //#region package.json
-var version = "1.1.5";
+var version = "1.1.7";
 //#endregion
 //#region src/io/document-input.ts
 const EXTENSION_TO_FORMAT = {
@@ -370,7 +370,7 @@ function registerMetadataTools(server) {
 	});
 	server.registerTool("metadata_write", {
 		title: "Write document metadata",
-		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); xlsx and odf are rejected outright as either a source or a target, in both directions. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
+		description: "Patches a document's own title/author/subject/keywords, leaving every other field and every other flag as-is. Does not convert format -- the source document's own format and targetFormat must match (or both be 'pdf'); odf (a standalone formula document) is rejected outright as either a source or a target, since it has no write path back out at all. Convert the document to a different format first (e.g. with a documents.js conversion tool) if metadata needs to be set on the result of a format change.",
 		inputSchema: z.object({
 			source: DocumentInputSchema.describe("The document to patch metadata on."),
 			targetFormat: DocumentFormatSchema.describe("The format to write the patched document back out as -- must match the source document's own format (or both be 'pdf'). metadata_write never converts format."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "document-mcp",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "MCP (Model Context Protocol) server exposing documents.js's document-conversion, .odb, metadata, and font tooling as MCP tools.",
   "type": "module",
   "repository": {
@@ -69,7 +69,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "@modelcontextprotocol/server": "^2.0.0",
-    "documents.js": "^1.79.0",
+    "documents.js": "^1.81.8",
     "pdf-codec": "^1.11.0",
     "zod": "^4.2.0"
   },