mcp-word-bridge 3.2.2 → 3.2.4

package/README.md

@@ -5,7 +5,7 @@ MCP server for live Word document editing via Office Add-in. Enables programmati
 ## Architecture
 
 ```
-MCP Client ←stdio→ index.js ←WebSocket→ Taskpane (Office Add-in) ←→ Word JS API ←→ Word Document
+MCP Client←stdio→index.js←WebSocket→Taskpane (Office Add-in)←→Word JS API←→Word Document
 ```
 
 Single process. The MCP client spawns `index.js`, which starts both the HTTPS bridge server (for the add-in) and the MCP server (on stdio). Everything starts and stops together.
@@ -24,15 +24,14 @@ Restart Word → Home → Add-ins → **MCP Word Bridge**
 
 ### 2. Add MCP config
 
-Add to your MCP client configuration (e.g. `.kiro/settings/mcp.json`):
+Add to your MCP client configuration:
 
 ```json
 {
   "mcpServers": {
     "word-bridge": {
       "command": "npx",
-      "args": ["-y", "mcp-word-bridge"],
-      "disabled": false
+      "args": ["-y", "mcp-word-bridge"]
     }
   }
 }
@@ -69,39 +68,155 @@ mcp-word-bridge/
 
 ## Tools (82)
 
-**Document:** get_text, get_document_properties, set_document_properties, save, get_word_count, get_styles, get_coauthors, set_change_tracking
-
-**Paragraphs:** get_paragraphs, get_paragraph_by_index, insert_paragraph, delete_paragraph, set_paragraph_style, set_paragraph_spacing
-
-**Search & Text:** search, search_and_replace, insert_text, get_selection_info, insert_text_at_selection, insert_line_break
-
-**Formatting:** format_text, clear_formatting, get_font_info
-
-**Tables:** insert_table, get_tables, get_table_data, set_table_cell, add_table_row, delete_table_row, merge_table_cells, split_table_cell, set_table_style, set_table_cell_shading
-
-**Lists:** insert_list, get_list_info, set_list_level
-
-**Comments:** add_comment, get_comments, get_comment_replies, reply_to_comment, resolve_comment, delete_comment
-
-**Footnotes/Endnotes:** insert_footnote, insert_footnote_at_index, insert_endnote, get_footnotes, get_endnotes, delete_footnote, delete_endnote
-
-**Track Changes:** get_tracked_changes, accept_tracked_change, reject_tracked_change, accept_all_tracked_changes, reject_all_tracked_changes
-
-**Content Controls:** get_content_controls, insert_content_control, set_content_control_text
-
-**Bookmarks:** get_bookmarks, insert_bookmark, delete_bookmark, go_to_bookmark, get_bookmark_text
-
-**Hyperlinks:** insert_hyperlink, get_hyperlinks, remove_hyperlink
-
-**Headers/Footers:** get_header_footer, set_header_footer
-
-**Images:** insert_image, get_images, delete_image
-
-**Page Layout:** get_page_layout, set_page_layout, get_sections, insert_page_break, insert_section_break
-
-**Custom Properties:** get_custom_properties, set_custom_property, delete_custom_property
-
-**Advanced:** insert_html, insert_ooxml, insert_table_of_contents, get_fields
+### Document
+| Tool | Description |
+|------|-------------|
+| `word_get_text` | Get full plain text of the document |
+| `word_get_document_properties` | Get metadata (title, author, path, timestamps) |
+| `word_set_document_properties` | Set metadata fields |
+| `word_save` | Save document to disk |
+| `word_get_word_count` | Get word, character, and paragraph counts |
+| `word_get_styles` | List available styles |
+| `word_get_coauthors` | Get co-authoring status and active authors |
+| `word_set_change_tracking` | Enable/disable track changes |
+
+### Paragraphs
+| Tool | Description |
+|------|-------------|
+| `word_get_paragraphs` | Get paragraphs with style, alignment, TOC flag (paginated) |
+| `word_get_paragraph_by_index` | Get full details of one paragraph (font, spacing, indent) |
+| `word_insert_paragraph` | Insert a styled paragraph at Start or End |
+| `word_delete_paragraph` | Delete a paragraph by index |
+| `word_set_paragraph_style` | Change style or alignment of a paragraph |
+| `word_set_paragraph_spacing` | Set line spacing, before/after, and indentation |
+
+### Search & Text
+| Tool | Description |
+|------|-------------|
+| `word_search` | Find text matches (case-insensitive by default) |
+| `word_search_and_replace` | Find and replace all occurrences |
+| `word_insert_text` | Insert text before or after a search match |
+| `word_get_selection_info` | Get current selection with font details |
+| `word_insert_text_at_selection` | Insert or replace text at cursor |
+| `word_insert_line_break` | Insert a soft line break (Shift+Enter) |
+
+### Formatting
+| Tool | Description |
+|------|-------------|
+| `word_format_text` | Apply bold, italic, color, size, font to a text match |
+| `word_clear_formatting` | Reset formatting to paragraph style defaults |
+| `word_get_font_info` | Inspect font properties of a text match |
+
+### Tables
+| Tool | Description |
+|------|-------------|
+| `word_insert_table` | Insert a table with data and optional style |
+| `word_get_tables` | Get all tables with values and styles |
+| `word_get_table_data` | Get cell values from a specific table |
+| `word_set_table_cell` | Set text in a cell |
+| `word_add_table_row` | Add a row with optional values |
+| `word_delete_table_row` | Delete a row by index |
+| `word_merge_table_cells` | Merge a rectangular range of cells |
+| `word_split_table_cell` | Split a cell into rows/columns |
+| `word_set_table_style` | Apply a built-in table style |
+| `word_set_table_cell_shading` | Set cell background color |
+
+### Lists
+| Tool | Description |
+|------|-------------|
+| `word_insert_list` | Insert a bulleted or numbered list |
+| `word_get_list_info` | Get list level and numbering for a paragraph |
+| `word_set_list_level` | Change indent level of a list item |
+
+### Comments
+| Tool | Description |
+|------|-------------|
+| `word_add_comment` | Add a comment anchored to text |
+| `word_get_comments` | Get all comments with author, date, status |
+| `word_get_comment_replies` | Get replies for a comment |
+| `word_reply_to_comment` | Reply to a comment |
+| `word_resolve_comment` | Mark a comment as resolved |
+| `word_delete_comment` | Delete a comment and its replies |
+
+### Footnotes & Endnotes
+| Tool | Description |
+|------|-------------|
+| `word_insert_footnote` | Insert footnote anchored to a text match |
+| `word_insert_footnote_at_index` | Insert footnote at end of a paragraph |
+| `word_insert_endnote` | Insert endnote anchored to a text match |
+| `word_get_footnotes` | Get all footnotes with index and text |
+| `word_get_endnotes` | Get all endnotes with index and text |
+| `word_delete_footnote` | Delete a footnote by index |
+| `word_delete_endnote` | Delete an endnote by index |
+
+### Track Changes
+| Tool | Description |
+|------|-------------|
+| `word_get_tracked_changes` | Get all tracked changes with type, author, text |
+| `word_accept_tracked_change` | Accept a change by index |
+| `word_reject_tracked_change` | Reject a change by index |
+| `word_accept_all_tracked_changes` | Accept all changes |
+| `word_reject_all_tracked_changes` | Reject all changes |
+
+### Content Controls
+| Tool | Description |
+|------|-------------|
+| `word_get_content_controls` | Get all controls with id, tag, type, text |
+| `word_insert_content_control` | Wrap text in a RichText, PlainText, or CheckBox control |
+| `word_set_content_control_text` | Set text in a control by ID or tag |
+
+### Bookmarks
+| Tool | Description |
+|------|-------------|
+| `word_get_bookmarks` | List all bookmark names |
+| `word_insert_bookmark` | Create a bookmark at a text match |
+| `word_delete_bookmark` | Delete a bookmark by name |
+| `word_go_to_bookmark` | Navigate to a bookmark and select it |
+| `word_get_bookmark_text` | Get text content of a bookmark |
+
+### Hyperlinks
+| Tool | Description |
+|------|-------------|
+| `word_insert_hyperlink` | Add a hyperlink to existing text |
+| `word_get_hyperlinks` | List all hyperlinks with URLs and text |
+| `word_remove_hyperlink` | Remove link from text (keeps the text) |
+
+### Headers & Footers
+| Tool | Description |
+|------|-------------|
+| `word_get_header_footer` | Get header or footer text |
+| `word_set_header_footer` | Set header or footer text |
+
+### Images
+| Tool | Description |
+|------|-------------|
+| `word_insert_image` | Insert image from base64 data |
+| `word_get_images` | List images with dimensions and alt text |
+| `word_delete_image` | Delete an image by index |
+
+### Page Layout & Sections
+| Tool | Description |
+|------|-------------|
+| `word_get_page_layout` | Get margins, orientation, paper size |
+| `word_set_page_layout` | Set margins, orientation, paper size |
+| `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 |
+
+### Custom Properties
+| Tool | Description |
+|------|-------------|
+| `word_get_custom_properties` | Get all custom key-value properties |
+| `word_set_custom_property` | Create or update a custom property |
+| `word_delete_custom_property` | Delete a custom property |
+
+### Advanced
+| Tool | Description |
+|------|-------------|
+| `word_insert_html` | Insert HTML converted to native Word formatting |
+| `word_insert_ooxml` | Insert raw Office Open XML |
+| `word_insert_table_of_contents` | Insert a TOC based on headings |
+| `word_get_fields` | Get all fields (hyperlinks, TOC, page numbers) |
 
 ## How it works
 
@@ -112,21 +227,23 @@ mcp-word-bridge/
 5. Changes go through Word's editing pipeline — cursor follows edits like a human typing
 6. When the MCP client terminates the process, the bridge server stops automatically
 
-## Regenerating TLS Certificates
-
-A self-signed localhost certificate is **auto-generated on first run** if `certs/cert.pem` and `certs/key.pem` don't exist. No manual step needed.
+## TLS Certificate
 
-To trust the cert (required for Word to connect without warnings):
+A self-signed localhost certificate is **auto-generated on first run** if `certs/cert.pem` and `certs/key.pem` don't exist. The server prints the exact trust command with the resolved path:
 
-**macOS:**
-```bash
-sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain node_modules/mcp-word-bridge/certs/cert.pem
 ```
+[mcp-word-bridge] ✓ Certificate generated.
+[mcp-word-bridge]
+[mcp-word-bridge] To trust the certificate (required once for Word to connect):
+[mcp-word-bridge]   security add-trusted-cert -r trustRoot -k ~/Library/Keychains/login.keychain-db "/path/to/certs/cert.pem"
+```
+
+Run the printed command once. No `sudo` required — it adds to your user login keychain.
 
-**To regenerate manually:**
+**To regenerate:**
 ```bash
 rm certs/cert.pem certs/key.pem
-node index.js  # will regenerate on startup
+# restart the MCP server — it will regenerate and print the trust command again
 ```
 
 ## Known Limitations & Word API Behavior

package/index.js

@@ -40,8 +40,17 @@ function ensureCerts() {
     ].join('\n'));
   }
   execSync('openssl req -x509 -newkey rsa:2048 -keyout "' + keyPath + '" -out "' + certPath + '" -days 3650 -nodes -config "' + confPath + '"', { stdio: 'pipe' });
-  process.stderr.write('[mcp-word-bridge] Certificate generated at ' + CERTS_DIR + '\n');
-  process.stderr.write('[mcp-word-bridge] NOTE: You may need to trust this cert in your OS keychain for Word to connect.\n');
+  process.stderr.write('[mcp-word-bridge] ✓ Certificate generated.\n');
+  process.stderr.write('[mcp-word-bridge]\n');
+  process.stderr.write('[mcp-word-bridge] To trust the certificate (required once for Word to connect):\n');
+  if (process.platform === 'darwin') {
+    process.stderr.write('[mcp-word-bridge]   security add-trusted-cert -r trustRoot -k ~/Library/Keychains/login.keychain-db "' + certPath + '"\n');
+  } else if (process.platform === 'win32') {
+    process.stderr.write('[mcp-word-bridge]   certutil -user -addstore Root "' + certPath + '"\n');
+  } else {
+    process.stderr.write('[mcp-word-bridge]   sudo cp "' + certPath + '" /usr/local/share/ca-certificates/ && sudo update-ca-certificates\n');
+  }
+  process.stderr.write('[mcp-word-bridge]\n');
 }
 
 ensureCerts();

package/package.json

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