mcp-word-bridge 3.4.0 → 3.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,5 +1,8 @@
1
1
  # MCP Word Bridge
2
2
 
3
+ [![Tests](https://github.com/likelion/mcp-word-bridge/actions/workflows/tests.yml/badge.svg)](https://github.com/likelion/mcp-word-bridge/actions/workflows/tests.yml)
4
+ [![codecov](https://codecov.io/gh/likelion/mcp-word-bridge/branch/main/graph/badge.svg)](https://codecov.io/gh/likelion/mcp-word-bridge)
5
+
3
6
  MCP server for live Word document editing via Office Add-in. Enables programmatic editing of Word documents through the Word JavaScript API, with changes appearing as user edits in co-authoring sessions.
4
7
 
5
8
  ## Architecture
@@ -53,20 +56,31 @@ That's it. The MCP server starts automatically when your MCP client loads the co
53
56
 
54
57
  ```
55
58
  mcp-word-bridge/
56
- ├── index.js # Single entry point (MCP + bridge server)
59
+ ├── index.js # Entry point: HTTPS server + MCP handlers + WebSocket relay
60
+ ├── lib/
61
+ │ ├── tools.js # Tool definitions (87) and action mapping
62
+ │ ├── equations.js # LaTeX→OMML pipeline (fixDelimiters, fixNaryOperands, latexToOmml)
63
+ │ └── usage-guide.js # MCP resource content (usage patterns for LLMs)
64
+ ├── taskpane-app.js # Client-side Word JS API logic (runs in add-in)
57
65
  ├── install-manifest.js # Manifest sideloader (npx mcp-word-bridge-install)
58
66
  ├── taskpane.html # Served to Word add-in
59
- ├── taskpane-app.js # Client-side Word JS API logic
60
67
  ├── certs/
61
68
  │ ├── cert.pem # Self-signed TLS cert
62
69
  │ ├── key.pem # TLS private key
63
70
  │ └── cert.conf # OpenSSL config for cert regeneration
64
71
  ├── manifest.xml # Office add-in manifest
72
+ ├── test/
73
+ │ ├── mcp-protocol.test.js # Tool schema & mapping tests (CI)
74
+ │ ├── equations.test.js # LaTeX→OMML pipeline tests (CI)
75
+ │ ├── validation.test.js # Input validation tests (CI)
76
+ │ └── live/ # Integration tests against real Word (manual)
77
+ │ ├── run-all.test.js
78
+ │ └── bridge-client.js
65
79
  ├── package.json
66
80
  └── README.md
67
81
  ```
68
82
 
69
- ## Tools (85)
83
+ ## Tools (87)
70
84
 
71
85
  ### Document
72
86
  | Tool | Description |
@@ -75,6 +89,8 @@ mcp-word-bridge/
75
89
  | `word_get_document_properties` | Get metadata (title, author, path, timestamps) |
76
90
  | `word_set_document_properties` | Set metadata fields |
77
91
  | `word_save` | Save document to disk |
92
+ | `word_clear` | Clear all document body content. Leaves one empty Normal paragraph. |
93
+ | `word_create_document` | Create and open a new blank document in a new Word window |
78
94
  | `word_get_word_count` | Get word, character, and paragraph counts |
79
95
  | `word_get_styles` | List available styles |
80
96
  | `word_get_coauthors` | Get co-authoring status and active authors |