mcp-word-bridge 3.2.0 → 3.2.1

package/README.md

@@ -12,14 +12,16 @@ Single process. The MCP client spawns `index.js`, which starts both the HTTPS br
 
 ## Setup
 
-### 1. Sideload the add-in manifest
-
-Copy the manifest to Word's sideload directory:
+### 1. Install and sideload the add-in
 
 ```bash
-cp manifest.xml ~/Library/Containers/com.microsoft.Word/Data/Documents/wef/
+npx mcp-word-bridge-install
 ```
 
+This copies the manifest into Word's sideload directory. On macOS it's automatic; on Windows it attempts the standard location and prints manual steps if needed.
+
+Restart Word → Home → Add-ins → **MCP Word Bridge**
+
 ### 2. Add MCP config
 
 Add to your MCP client configuration (e.g. `.kiro/settings/mcp.json`):
@@ -28,8 +30,8 @@ Add to your MCP client configuration (e.g. `.kiro/settings/mcp.json`):
 {
   "mcpServers": {
     "word-bridge": {
-      "command": "node",
-      "args": ["/path/to/word-addin/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-word-bridge"],
       "disabled": false
     }
   }
@@ -51,15 +53,16 @@ That's it. The MCP server starts automatically when your MCP client loads the co
 ## File Layout
 
 ```
-word-addin/
-├── index.js           # Single entry point (MCP + bridge server)
-├── taskpane.html      # Served to Word add-in
-├── taskpane-app.js    # Client-side Word JS API logic
+mcp-word-bridge/
+├── index.js              # Single entry point (MCP + bridge server)
+├── install-manifest.js   # Manifest sideloader (npx mcp-word-bridge-install)
+├── taskpane.html         # Served to Word add-in
+├── taskpane-app.js       # Client-side Word JS API logic
 ├── certs/
-│   ├── cert.pem       # Self-signed TLS cert
-│   └── key.pem        # TLS private key
-├── manifest.xml       # Office add-in manifest (sideloaded)
-├── cert.conf          # OpenSSL config for cert regeneration
+│   ├── cert.pem          # Self-signed TLS cert
+│   ├── key.pem           # TLS private key
+│   └── cert.conf         # OpenSSL config for cert regeneration
+├── manifest.xml          # Office add-in manifest
 ├── package.json
 └── README.md
 ```
@@ -114,7 +117,7 @@ word-addin/
 The self-signed cert is required for the HTTPS connection to the taskpane. To regenerate:
 
 ```bash
-openssl req -x509 -newkey rsa:2048 -keyout certs/key.pem -out certs/cert.pem -days 3650 -nodes -config cert.conf
+openssl req -x509 -newkey rsa:2048 -keyout certs/key.pem -out certs/cert.pem -days 3650 -nodes -config certs/cert.conf
 ```
 
 Then trust the cert in Keychain Access (macOS) to avoid browser warnings.

package/install-manifest.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * Sideload the Word add-in manifest.
+ * Run manually: npx mcp-word-bridge-install
+ * Or: node node_modules/mcp-word-bridge/install-manifest.js
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const manifestSrc = path.join(__dirname, 'manifest.xml');
+
+if (process.platform === 'darwin') {
+  const wefDir = path.join(os.homedir(), 'Library/Containers/com.microsoft.Word/Data/Documents/wef');
+  const dest = path.join(wefDir, 'manifest.xml');
+
+  if (!fs.existsSync(wefDir)) {
+    fs.mkdirSync(wefDir, { recursive: true });
+  }
+  fs.copyFileSync(manifestSrc, dest);
+  console.log('✓ Manifest installed to: ' + dest);
+  console.log('  Restart Word, then: Home → Add-ins → MCP Word Bridge');
+} else if (process.platform === 'win32') {
+  const wefDir = path.join(os.homedir(), 'AppData', 'Local', 'Microsoft', 'Office', '16.0', 'Wef');
+  try {
+    if (!fs.existsSync(wefDir)) {
+      fs.mkdirSync(wefDir, { recursive: true });
+    }
+    const dest = path.join(wefDir, 'manifest.xml');
+    fs.copyFileSync(manifestSrc, dest);
+    console.log('✓ Manifest installed to: ' + dest);
+    console.log('  Restart Word, then: Insert → My Add-ins → Developer Add-ins');
+  } catch (e) {
+    console.log('Could not auto-install manifest on Windows.');
+    console.log('Manual steps:');
+    console.log('  1. Copy this file to a local folder: ' + manifestSrc);
+    console.log('  2. In Word: File → Options → Trust Center → Trusted Add-in Catalogs');
+    console.log('  3. Add the folder path as a catalog');
+    console.log('  4. Insert → My Add-ins → Shared Folder → MCP Word Bridge');
+  }
+} else {
+  console.log('Platform not supported for local sideloading.');
+  console.log('For Word on the Web, upload the manifest via the admin center.');
+  console.log('Manifest location: ' + manifestSrc);
+}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "mcp-word-bridge",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "description": "MCP server for live Word document editing via Office Add-in",
   "main": "index.js",
   "bin": {
-    "mcp-word-bridge": "index.js"
+    "mcp-word-bridge": "index.js",
+    "mcp-word-bridge-install": "install-manifest.js"
   },
   "scripts": {
-    "start": "node index.js"
+    "start": "node index.js",
+    "install-manifest": "node install-manifest.js"
   },
   "keywords": ["mcp", "word", "office", "add-in", "document", "editing"],
   "author": "Leonid Mokrushin <likelion@gmail.com>",