carson-word-bridge-mcp

Stdio MCP server for the Carson local Word bridge.

This package assumes:

• Carson desktop is running locally so the bridge is available on 127.0.0.1
• the Word add-in is installed and open in at least one document

MCP config

For installed usage via npm:

{
  "mcpServers": {
    "carson-word-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "carson-word-bridge-mcp"],
      "env": {}
    }
  }
}

For local repo development:

{
  "mcpServers": {
    "carson-word-bridge": {
      "type": "stdio",
      "command": "pnpm",
      "args": [
        "exec",
        "node",
        "./packages/word-bridge-mcp/src/bin-word-bridge-mcp.js"
      ],
      "env": {}
    }
  }
}

Primary executable:

• word-bridge-mcp

Downstream: the docx Claude Code plugin (Fix-Fast/corgi)

This MCP is packaged for end-users as the docx plugin in the Fix-Fast/corgi Claude Code marketplace. The plugin ships:

• a word-bridge skill that instructs Claude how to use this MCP (prefer the live Word bridge, fall back to Anthropic's document-skills for offline file work), and
• a .mcp.json that spawns this server via npx -y carson-word-bridge-mcp.

End-users install it with the one-liner curl -fsSL https://word.usecarson.com/install.sh | bash (generated from apps/word-addin/scripts/manifest-utils.mjs and served by the word-addin Porter deployment).

Sync process (carson → corgi)

Today this is manual. When you change either of the following in carson, mirror the change into Fix-Fast/corgi:

| You change this in carson | You must update this in corgi | | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | | packages/word-bridge-mcp/src/mcp-server.mjs (tool surface) | skills/word-bridge/SKILL.md — keep the MCP tool list and guidance accurate | | packages/word-bridge-mcp/package.json version | nothing required if .mcp.json uses unpinned carson-word-bridge-mcp; bump corgi's plugin.json version to signal the release | | Install flow (apps/word-addin/scripts/manifest-utils.mjs) | nothing — install.sh is generated + deployed to word.usecarson.com from this repo |

Publishing the MCP to npm happens from this repo (pnpm --filter carson-word-bridge-mcp publish). The corgi repo only needs file-level updates to the skill markdown.

A push-based GitHub Action in carson is on the TODO list to automate the skill/plugin version mirror. Until then, commit + push to Fix-Fast/corgi manually after carson changes land.