mcp-word-bridge 3.5.0 → 3.5.1

package/README.md

@@ -80,7 +80,7 @@ mcp-word-bridge/
 └── README.md
 ```
 
-## Tools (90)
+## Tools (91)
 
 ### Document
 | Tool | Description |
@@ -222,6 +222,7 @@ mcp-word-bridge/
 | `word_get_sections` | List all sections with page setup |
 | `word_insert_page_break` | Insert a page break after a paragraph |
 | `word_insert_section_break` | Insert a section break after a paragraph |
+| `word_get_page_info` | Get page count and per-page paragraphs with document indices (Desktop only) |
 
 ### Custom Properties
 | Tool | Description |

package/index.js

@@ -134,7 +134,7 @@ function sendToTaskpane(action, params) {
 }
 
 const mcpServer = new Server(
-  { name: 'mcp-word-bridge', version: '3.5.0' },
+  { name: 'mcp-word-bridge', version: '3.5.1' },
   { capabilities: { tools: {}, resources: {} } }
 );
 

package/lib/tools.js

@@ -100,6 +100,7 @@ const tools = [
   { name: 'word_get_sections', description: '[Layout] List all sections with their page setup (margins, orientation, paper size).', inputSchema: { type: 'object', properties: {} } },
   { name: 'word_insert_page_break', description: '[Layout] Insert a page break after a paragraph. Omit paragraphIndex to insert at end of document.', inputSchema: { type: 'object', properties: { paragraphIndex: { type: 'number', description: 'Paragraph index (0-based). Omit for end of document.' } } } },
   { name: 'word_insert_section_break', description: '[Layout] Insert a section break after a paragraph. Cannot be used inside table cells.', inputSchema: { type: 'object', properties: { paragraphIndex: { type: 'number', description: 'Paragraph index (0-based). Omit for end of document.' }, breakType: { type: 'string', enum: ['SectionNext', 'SectionContinuous', 'SectionEven', 'SectionOdd'], description: 'Default: SectionNext' } } } },
+  { name: 'word_get_page_info', description: '[Layout] Get page count and per-page paragraph ranges. Returns page dimensions and the first/last document paragraph index for each page. Use with word_get_paragraphs to read specific page content.', inputSchema: { type: 'object', properties: {} } },
   // 16. CUSTOM PROPERTIES
   { name: 'word_get_custom_properties', description: '[Properties] Get all custom document properties (key-value pairs with types).', inputSchema: { type: 'object', properties: {} } },
   { name: 'word_set_custom_property', description: '[Properties] Set a custom document property. Creates or updates the key-value pair.', inputSchema: { type: 'object', properties: { key: { type: 'string' }, value: { type: 'string' } }, required: ['key', 'value'] } },
@@ -161,6 +162,7 @@ const toolActionMap = {
   word_delete_custom_property: 'deleteCustomProperty',
   word_insert_html: 'insertHtml', word_insert_ooxml: 'insertOoxml',
   word_insert_table_of_contents: 'insertTableOfContents', word_get_fields: 'getFields',
+  word_get_page_info: 'getPageInfo',
   // word_insert_equation, word_batch, word_get_document_outline, word_move_paragraph
   // are handled directly in index.js (not via taskpane action map)
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-word-bridge",
-  "version": "3.5.0",
+  "version": "3.5.1",
   "description": "MCP server for live Word document editing via Office Add-in",
   "main": "index.js",
   "bin": {

package/taskpane-app.js

@@ -1431,6 +1431,55 @@ commands.clearFormatting = (p) => Word.run(async (ctx) => {
   return { success: true };
 });
 
+// == PAGE INFO (WordApiDesktop 1.2+) ==
+commands.getPageInfo = async () => {
+  if (!Office.context.requirements.isSetSupported('WordApiDesktop', '1.2')) {
+    throw new Error('Page API not available on this platform (requires desktop Word).');
+  }
+  return Word.run(async (ctx) => {
+    const bodyRange = ctx.document.body.getRange();
+    const pages = bodyRange.pages;
+    pages.load('items');
+    await ctx.sync();
+    const pageCount = pages.items.length;
+    // Load all body paragraphs to map page boundaries to document indices
+    const allParas = ctx.document.body.paragraphs;
+    allParas.load('text,style');
+    await ctx.sync();
+    const pageDetails = [];
+    const usedIndices = new Set();
+    for (let i = 0; i < pages.items.length; i++) {
+      const page = pages.items[i];
+      page.load('index,height,width');
+      const paras = page.getRange().paragraphs;
+      paras.load('text,style');
+      await ctx.sync();
+      let firstIdx = -1;
+      let lastIdx = -1;
+      for (let j = 0; j < paras.items.length; j++) {
+        const p = paras.items[j];
+        for (let k = 0; k < allParas.items.length; k++) {
+          if (!usedIndices.has(k) && allParas.items[k].text === p.text && allParas.items[k].style === p.style) {
+            usedIndices.add(k);
+            if (firstIdx === -1) firstIdx = k;
+            lastIdx = k;
+            break;
+          }
+        }
+      }
+      pageDetails.push({
+        pageIndex: page.index,
+        height: page.height,
+        width: page.width,
+        paragraphCount: paras.items.length,
+        firstParagraphIndex: firstIdx,
+        lastParagraphIndex: lastIdx
+      });
+    }
+    return { pageCount, pages: pageDetails };
+  });
+};
+
 // == INSERT TOC ==
 commands.insertTableOfContents = (p) => Word.run(async (ctx) => {
   const body = ctx.document.body;