mcp-word-bridge 3.2.1 → 3.2.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leonid Mokrushin
+
+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

@@ -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
 
@@ -114,13 +229,20 @@ mcp-word-bridge/
 
 ## Regenerating TLS Certificates
 
-The self-signed cert is required for the HTTPS connection to the taskpane. To regenerate:
+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.
+
+To trust the cert (required for Word to connect without warnings):
 
+**macOS:**
 ```bash
-openssl req -x509 -newkey rsa:2048 -keyout certs/key.pem -out certs/cert.pem -days 3650 -nodes -config certs/cert.conf
+sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain node_modules/mcp-word-bridge/certs/cert.pem
 ```
 
-Then trust the cert in Keychain Access (macOS) to avoid browser warnings.
+**To regenerate manually:**
+```bash
+rm certs/cert.pem certs/key.pem
+node index.js  # will regenerate on startup
+```
 
 ## Known Limitations & Word API Behavior
 

package/index.js

@@ -21,6 +21,31 @@ const CERTS_DIR = path.join(__dirname, 'certs');
 // PART 1: HTTPS + WebSocket Bridge Server
 // ═══════════════════════════════════════════════════════════════════════════════
 
+// Generate self-signed certs if they don't exist
+function ensureCerts() {
+  const certPath = path.join(CERTS_DIR, 'cert.pem');
+  const keyPath = path.join(CERTS_DIR, 'key.pem');
+  if (fs.existsSync(certPath) && fs.existsSync(keyPath)) return;
+  process.stderr.write('[mcp-word-bridge] Generating self-signed TLS certificate for localhost...\n');
+  if (!fs.existsSync(CERTS_DIR)) fs.mkdirSync(CERTS_DIR, { recursive: true });
+  const { execSync } = require('child_process');
+  const confPath = path.join(CERTS_DIR, 'cert.conf');
+  if (!fs.existsSync(confPath)) {
+    fs.writeFileSync(confPath, [
+      '[req]', 'default_bits = 2048', 'prompt = no', 'default_md = sha256',
+      'distinguished_name = dn', 'x509_extensions = v3_req', '',
+      '[dn]', 'CN = localhost', '',
+      '[v3_req]', 'basicConstraints = CA:TRUE', 'subjectAltName = @alt_names', '',
+      '[alt_names]', 'DNS.1 = localhost', 'IP.1 = 127.0.0.1', ''
+    ].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');
+}
+
+ensureCerts();
+
 const sslOptions = {
   key: fs.readFileSync(path.join(CERTS_DIR, 'key.pem')),
   cert: fs.readFileSync(path.join(CERTS_DIR, 'cert.pem'))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-word-bridge",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "description": "MCP server for live Word document editing via Office Add-in",
   "main": "index.js",
   "bin": {
@@ -12,6 +12,10 @@
     "install-manifest": "node install-manifest.js"
   },
   "keywords": ["mcp", "word", "office", "add-in", "document", "editing"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/likelion/mcp-word-bridge.git"
+  },
   "author": "Leonid Mokrushin <likelion@gmail.com>",
   "license": "MIT",
   "dependencies": {

package/certs/cert.pem

@@ -1,19 +0,0 @@
------BEGIN CERTIFICATE-----
-MIIDATCCAemgAwIBAgIUXHIdF3kFBwDnYn+HtAfpiihdkx4wDQYJKoZIhvcNAQEL
-BQAwFDESMBAGA1UEAwwJbG9jYWxob3N0MB4XDTI2MDYwMTEzMDQxMFoXDTI3MDYw
-MTEzMDQxMFowFDESMBAGA1UEAwwJbG9jYWxob3N0MIIBIjANBgkqhkiG9w0BAQEF
-AAOCAQ8AMIIBCgKCAQEA30z83NusMTz0TTHfQN2lb7vQsBR+RcI6fNMEu9Diz2lO
-+NyvMhCY44esfr/h/LaT2t49HcuQF/1BN0UlbtKxRHU7Ex8lu6cPwYrYZgwcL+0p
-jyYdHeCb10kzGagOn86PLt6Q6TG+Rmiqi1P4Q6+bfsXGRj6tQkR5SxgMZFC4claM
-O7o9h1IibstyN+FP/5jZoVJOa0/qPe76292PwFYJXAen0J9ho2PLrTL78hVegG3v
-B0IqBtvf4fARnNbT+VLZMf+zYTmYh3rVEh2FHg9FejO1LWQpab4b6kA9HN4Uj7f6
-Fgjf/quIihLoMNGkZ5FrKpOy+UnTS5w0ZrBUmxhvpwIDAQABo0swSTAMBgNVHRME
-BTADAQH/MBoGA1UdEQQTMBGCCWxvY2FsaG9zdIcEfwAAATAdBgNVHQ4EFgQUHGnT
-m6TAtBX/3kEcyqsP1MjY8+AwDQYJKoZIhvcNAQELBQADggEBAFXEtaUBwTxp/nfs
-4r6L7xpbTERLx+/4R/8RNP09m9W31SsGHoTcVmqTZz9QtKzWdFUH5xxREOEvHnGA
-a6VAljMo6PYYcZlZH83CWwDbdlKdm7PVxEbtPWtz8B43lUVnBaRU6+RORTVSjvnU
-KfRtsLP30qctT8/ZjPWEcT2+5gOczYzECYtH5bVJdmr+rWJRVORwnEBVUnxWKJ0h
-1vK9yQ3dfJlMV6aHDmkSncyYwHvbV6rTn4aiaNW148ehF++NQ7/6bX2M4w6rcHfi
-tfRjoOnyCvN6km0PYbd7pKQzUVhJPUFMYPELiJpD8KxjjIL9fbjf+nQz069HgLYW
-vyKVAvE=
------END CERTIFICATE-----

package/certs/key.pem

@@ -1,28 +0,0 @@
------BEGIN PRIVATE KEY-----
-MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQDfTPzc26wxPPRN
-Md9A3aVvu9CwFH5Fwjp80wS70OLPaU743K8yEJjjh6x+v+H8tpPa3j0dy5AX/UE3
-RSVu0rFEdTsTHyW7pw/BithmDBwv7SmPJh0d4JvXSTMZqA6fzo8u3pDpMb5GaKqL
-U/hDr5t+xcZGPq1CRHlLGAxkULhyVow7uj2HUiJuy3I34U//mNmhUk5rT+o97vrb
-3Y/AVglcB6fQn2GjY8utMvvyFV6Abe8HQioG29/h8BGc1tP5Utkx/7NhOZiHetUS
-HYUeD0V6M7UtZClpvhvqQD0c3hSPt/oWCN/+q4iKEugw0aRnkWsqk7L5SdNLnDRm
-sFSbGG+nAgMBAAECggEADoDBEZUg52fGlDbvgZaDtrCTmsQR+XTmeJH6BjrIaGE2
-FFq89Dr4uxpmPSs4QcIX80io3oUInE5CDJVsm3iKs+ALULAessPkdZUPff0+XWyB
-XP9EN9sNNBvYekuce4ueaBRjhAnLimYk4Xy4LKk8p6yvtoM+nIW2/QYYU/GcMSzH
-wuq6U1aX4RopFKlNDHHCQa6+kqdVs/qKICu9Xd74GDtJ3RnNuw0OjHE09KSIEL0W
-ifiE9tZ1yQhxWsDFnhYKVwd2yYARiy4afP7ieLwEoIN4vngsz7H5RUJhFmEiyzbn
-P3kaMeaExNBYOjMXmqsGhiY6NoWzG3Gz7GTofIU1hQKBgQD6NW8fH6pzWvWiQ08r
-+ATnrPtMaoFVRUCpwMlJnM02cPXPIatM5y25fIuWkxWHa8YUXDcDacN5/R3mEdfn
-qTV3NrraXHBwaZprqikgWRCTCMypmNuYH0n+yA9i1m2Te4PyK4z9uaHC96+li6U3
-woceGKixzg3f5Q8JQy8XO5MBdQKBgQDkeB2D+6R7tA35pTgIjzZwtcK9PEOhIa8f
-WsdwSuh74PkAYnid7ksVzHhHo6dbWYKy8KA4TevTDepLWNQjkChsaYX+dcYOgsIW
-4ixrSbOlgqCtVtTP98ytSHaJspgCCQE2SzvC0IcZqYk9BOcH45TcFIyWfV15D3mw
-pqhPXDtNKwKBgEMAuCcvhaeqfgjb2YG+wyF/UzRdeRDqoKxUshKCaPnhOhIjxAmu
-BrKbRY4nCSbgl4SwRRMm6W/rdmw77wNcbrLj9xmuk3Wm8fFO+gBtmWCmhJgOFRAh
-oOEXlfcz0NgjxWu+ed0gLs9VILZGNRI/h4tpsxMaSODiKCqk0SF5lJ5ZAoGBAJDR
-6rOsoTigi3NBXWFfljyfmk9lkeDjfyQ64My3TuKnWm75/Ebvs7yfnWabwAvRk11l
-1cma6u8flPIp3l6klFsUEJGZie/MxsbGmy1uzGcPhFYcAk3JX34/vpPOFzjDCHen
-/LuifuCvbIS3RNLlWYifpfYGhWelfZeSLIIRjq19AoGAUnDp4GFohF8/zExNj4lv
-dGD3GO6Qj401PbhBWjba22JD4V8yHFCPJOsdsiC/KCNeRirbupM+vivxXbNGuNr6
-g+H9sJrOJ4jKZBpjW3T/WVMpQhN498zKKqtUs0GYdDV9aFq4ywTDE0F3/QiWq6RM
-JD0eQifgAJsBmX+bcnej+ws=
------END PRIVATE KEY-----