mcp-word-bridge 4.1.3 → 4.1.4

package/README.md

@@ -60,7 +60,7 @@ MCP Client ←stdio→ Server ←WebSocket→ Taskpane (Office Add-in) ←→ Wo
 
 Single process. The MCP client spawns the server, which starts both the HTTPS bridge (for the add-in) and the MCP protocol handler (on stdio). Everything starts and stops together.
 
-## Tools (92)
+## Tools (91)
 
 ### Document
 | Tool | Description |

package/dist/server.js

@@ -18723,7 +18723,7 @@ var Bridge = class {
 
 // src/server/mcp.ts
 var import_server = require("@modelcontextprotocol/sdk/server/index.js");
-var import_types9 = require("@modelcontextprotocol/sdk/types.js");
+var import_types10 = require("@modelcontextprotocol/sdk/types.js");
 
 // src/server/types.ts
 var ToolError = class extends Error {
@@ -18781,7 +18781,15 @@ var setDocumentProperties = forwardTool(
       format: { type: "string" }
     }
   },
-  "setDocumentProperties"
+  "setDocumentProperties",
+  (args) => {
+    const hasProperty = args.title !== void 0 || args.subject !== void 0 || args.author !== void 0 || args.keywords !== void 0 || args.comments !== void 0 || args.category !== void 0 || args.company !== void 0 || args.manager !== void 0 || args.format !== void 0;
+    if (!hasProperty) {
+      throw new ToolError(
+        "At least one document property must be provided (title, subject, author, keywords, comments, category, company, manager, format)."
+      );
+    }
+  }
 );
 var save = forwardTool(
   "word_save",
@@ -18886,18 +18894,6 @@ function checkBounds(index, count, name) {
     );
   }
 }
-function checkOccurrence(occurrence, count) {
-  const idx = occurrence ?? 0;
-  if (idx < 0) {
-    throw new ToolError("occurrence must be non-negative (0-indexed).");
-  }
-  if (idx >= count) {
-    throw new ToolError(
-      `Occurrence ${idx} not found (only ${count} match${count === 1 ? "" : "es"}).`
-    );
-  }
-  return idx;
-}
 var MAX_SPACING_POINTS = 1584;
 var MAX_CUSTOM_PROPERTY_KEY_LENGTH = 255;
 function checkSpacingBounds(value, name) {
@@ -19032,7 +19028,12 @@ var setParagraphStyle = forwardTool(
     },
     required: ["index"]
   },
-  "setParagraphStyle"
+  "setParagraphStyle",
+  (args) => {
+    if (args.style === void 0 && args.alignment === void 0) {
+      throw new ToolError('At least one of "style" or "alignment" must be provided.');
+    }
+  }
 );
 var setParagraphSpacing = {
   name: "word_set_paragraph_spacing",
@@ -19279,7 +19280,10 @@ var insertTextAtMatch = forwardTool(
     },
     required: ["text"]
   },
-  "insertText"
+  "insertText",
+  (args) => {
+    checkNonEmpty(args.text, "text");
+  }
 );
 var getSelectionInfo = forwardTool(
   "word_get_selection_info",
@@ -19386,7 +19390,10 @@ var clearFormatting = forwardTool(
     },
     required: ["text"]
   },
-  "clearFormatting"
+  "clearFormatting",
+  (args) => {
+    checkNonEmpty(args.text, "text");
+  }
 );
 var getFontInfo = forwardTool(
   "word_get_font_info",
@@ -19399,7 +19406,10 @@ var getFontInfo = forwardTool(
     },
     required: ["text"]
   },
-  "getFontInfo"
+  "getFontInfo",
+  (args) => {
+    checkNonEmpty(args.text, "text");
+  }
 );
 var formattingTools = [
   formatText,
@@ -19422,7 +19432,24 @@ var insertTable = forwardTool(
     },
     required: ["rows", "cols"]
   },
-  "insertTable"
+  "insertTable",
+  (args) => {
+    const rows = args.rows;
+    const cols = args.cols;
+    if (typeof rows !== "number" || !Number.isInteger(rows) || rows <= 0) throw new ToolError("rows must be a positive integer (minimum 1).");
+    if (typeof cols !== "number" || !Number.isInteger(cols) || cols <= 0) throw new ToolError("cols must be a positive integer (minimum 1).");
+    if (cols > 63) throw new ToolError("cols must not exceed 63 (Word maximum column limit).");
+    if (rows > 500) throw new ToolError("rows must not exceed 500 (practical limit for performance).");
+    if (args.data !== void 0) {
+      const data = args.data;
+      if (!Array.isArray(data)) throw new ToolError("data must be an array of arrays.");
+      if (data.length !== rows) throw new ToolError(`Data rows (${data.length}) do not match specified rows (${rows}). Provide exactly ${rows} row(s) in the data array.`);
+      for (let i = 0; i < data.length; i++) {
+        if (!Array.isArray(data[i])) throw new ToolError(`data[${i}] must be an array.`);
+        if (data[i].length !== cols) throw new ToolError(`Data row ${i} has ${data[i].length} columns but expected ${cols}.`);
+      }
+    }
+  }
 );
 var listTables = forwardTool(
   "word_list_tables",
@@ -19453,7 +19480,12 @@ var setTableCell = forwardTool(
     },
     required: ["tableIndex", "row", "col", "text"]
   },
-  "setTableCell"
+  "setTableCell",
+  (args) => {
+    checkNonNegative(args.tableIndex, "tableIndex");
+    checkNonNegative(args.row, "row");
+    checkNonNegative(args.col, "col");
+  }
 );
 var addTableRow = forwardTool(
   "word_add_table_row",
@@ -19478,7 +19510,11 @@ var deleteTableRow = forwardTool(
     },
     required: ["tableIndex", "rowIndex"]
   },
-  "deleteTableRow"
+  "deleteTableRow",
+  (args) => {
+    checkNonNegative(args.tableIndex, "tableIndex");
+    checkNonNegative(args.rowIndex, "rowIndex");
+  }
 );
 var mergeTableCells = forwardTool(
   "word_merge_table_cells",
@@ -19493,7 +19529,17 @@ var mergeTableCells = forwardTool(
     },
     required: ["tableIndex", "topRow", "firstCell", "bottomRow", "lastCell"]
   },
-  "mergeTableCells"
+  "mergeTableCells",
+  (args) => {
+    checkNonNegative(args.tableIndex, "tableIndex");
+    checkNonNegative(args.topRow, "topRow");
+    checkNonNegative(args.firstCell, "firstCell");
+    checkNonNegative(args.bottomRow, "bottomRow");
+    checkNonNegative(args.lastCell, "lastCell");
+    if (args.topRow > args.bottomRow) throw new ToolError(`topRow (${args.topRow}) must be less than or equal to bottomRow (${args.bottomRow}).`);
+    if (args.firstCell > args.lastCell) throw new ToolError(`firstCell (${args.firstCell}) must be less than or equal to lastCell (${args.lastCell}).`);
+    if (args.topRow === args.bottomRow && args.firstCell === args.lastCell) throw new ToolError("Cannot merge a single cell with itself. Provide a range spanning at least 2 cells.");
+  }
 );
 var splitTableCell = forwardTool(
   "word_split_table_cell",
@@ -19508,7 +19554,14 @@ var splitTableCell = forwardTool(
     },
     required: ["tableIndex", "row", "col"]
   },
-  "splitTableCell"
+  "splitTableCell",
+  (args) => {
+    checkNonNegative(args.tableIndex, "tableIndex");
+    checkNonNegative(args.row, "row");
+    checkNonNegative(args.col, "col");
+    if (args.rowCount !== void 0 && (typeof args.rowCount !== "number" || args.rowCount <= 0)) throw new ToolError("rowCount must be a positive integer.");
+    if (args.colCount !== void 0 && (typeof args.colCount !== "number" || args.colCount <= 0)) throw new ToolError("colCount must be a positive integer.");
+  }
 );
 var setTableStyle = forwardTool(
   "word_set_table_style",
@@ -19534,7 +19587,13 @@ var setTableCellShading = forwardTool(
     },
     required: ["tableIndex", "row", "col", "color"]
   },
-  "setTableCellShading"
+  "setTableCellShading",
+  (args) => {
+    checkNonNegative(args.tableIndex, "tableIndex");
+    checkNonNegative(args.row, "row");
+    checkNonNegative(args.col, "col");
+    checkHexColor(args.color, "color");
+  }
 );
 var tableTools = [
   insertTable,
@@ -20055,7 +20114,15 @@ var setPageLayout = forwardTool(
       paperSize: { type: "string", description: "Letter, A4, etc." }
     }
   },
-  "setPageLayout"
+  "setPageLayout",
+  (args) => {
+    const hasProperty = args.orientation !== void 0 || args.topMargin !== void 0 || args.bottomMargin !== void 0 || args.leftMargin !== void 0 || args.rightMargin !== void 0 || args.paperSize !== void 0;
+    if (!hasProperty) {
+      throw new ToolError(
+        "At least one layout property must be provided (orientation, topMargin, bottomMargin, leftMargin, rightMargin, paperSize)."
+      );
+    }
+  }
 );
 var getSections = forwardTool(
   "word_get_sections",
@@ -20193,7 +20260,10 @@ var deleteCustomProperty = forwardTool(
     },
     required: ["key"]
   },
-  "deleteCustomProperty"
+  "deleteCustomProperty",
+  (args) => {
+    checkNonEmpty(args.key, "key");
+  }
 );
 var propertyTools = [
   getCustomProperties,
@@ -20253,7 +20323,6 @@ async function loadEquationLib() {
     buildEquationOoxml2 = lib.buildEquationOoxml;
   }
 }
-var MARKER = "\u200B\uFEFF\u200B";
 var insertEquation = {
   name: "word_insert_equation",
   description: "[Equations] Insert a LaTeX math equation as a native editable Word equation. Display mode (default) inserts a centered block. Inline mode inserts after a search match (provide anchorText) or at cursor.",
@@ -20272,6 +20341,7 @@ var insertEquation = {
     await loadEquationLib();
     const { mml2omml: mml2omml2 } = await Promise.resolve().then(() => (init_dist(), dist_exports));
     const latex = args.latex;
+    checkNonEmpty(latex, "latex");
     const displayMode = args.displayMode !== false;
     let result;
     try {
@@ -20287,15 +20357,8 @@ var insertEquation = {
     } else if (args.anchorText) {
       const anchorText = args.anchorText;
       const matchCase = args.matchCase || false;
-      const searchResult = await bridge2.send("search", { query: anchorText, matchCase });
-      if (!searchResult || searchResult.count === 0) throw new ToolError("Anchor not found: " + anchorText);
-      const occurrence = checkOccurrence(args.occurrence, searchResult.count);
-      await bridge2.send("insertText", { text: " " + MARKER, after: anchorText, occurrence, matchCase });
-      try {
-        await bridge2.send("insertOoxmlAtSelection", { ooxml });
-      } finally {
-        await bridge2.send("searchAndReplace", { find: MARKER, replace: "" });
-      }
+      const occurrence = args.occurrence ?? 0;
+      await bridge2.send("insertOoxmlAfterMatch", { ooxml, anchorText, occurrence, matchCase });
     } else {
       await bridge2.send("insertOoxmlAtSelection", { ooxml });
     }
@@ -20596,7 +20659,7 @@ Output always uses canonical form: "Left", "Center", "Right", "Justified".
 // package.json
 var package_default = {
   name: "mcp-word-bridge",
-  version: "4.1.3",
+  version: "4.1.4",
   description: "MCP server for live Word document editing via Office Add-in",
   main: "dist/server.js",
   bin: {
@@ -20661,7 +20724,7 @@ function createMcpServer(bridge2) {
   );
   const { tools, handlers } = buildToolRegistry();
   const toolMutex = createMutex();
-  server.setRequestHandler(import_types9.ListToolsRequestSchema, async () => ({
+  server.setRequestHandler(import_types10.ListToolsRequestSchema, async () => ({
     tools: tools.map((t) => ({
       name: t.name,
       description: t.description,
@@ -20672,7 +20735,7 @@ function createMcpServer(bridge2) {
       }
     }))
   }));
-  server.setRequestHandler(import_types9.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(import_types10.CallToolRequestSchema, async (request) => {
     return toolMutex.run(async () => {
       const { name, arguments: args } = request.params;
       const handler = handlers.get(name);
@@ -20688,7 +20751,7 @@ function createMcpServer(bridge2) {
       }
     });
   });
-  server.setRequestHandler(import_types9.ListResourcesRequestSchema, async () => ({
+  server.setRequestHandler(import_types10.ListResourcesRequestSchema, async () => ({
     resources: [{
       uri: "word-bridge://usage-guide",
       name: "Word Bridge Usage Guide",
@@ -20696,7 +20759,7 @@ function createMcpServer(bridge2) {
       mimeType: "text/markdown"
     }]
   }));
-  server.setRequestHandler(import_types9.ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler(import_types10.ReadResourceRequestSchema, async (request) => {
     if (request.params.uri === "word-bridge://usage-guide") {
       return { contents: [{ uri: request.params.uri, mimeType: "text/markdown", text: usageGuide }] };
     }