bc-word-layout-mcp

An MCP (Model Context Protocol) server that lets AI agents create, edit, validate, and preview Microsoft Word report layouts for Microsoft Dynamics 365 Business Central through deterministic, typed tools — instead of free-hand OOXML editing, which is unreliable in a file format where a single misplaced element silently corrupts the document.

28 typed MCP tools over stdio: inspect any layout, validate it (structurally, and via a real dry-run merge), render an offline mock PDF preview the agent can look at, and author edits — fields, labels, repeater tables, nested detail rows, block repeaters, table structure, text and cell formatting, full lifecycle refresh. One uniform response envelope; nothing throws across the MCP boundary; every mutating edit is validated before it is saved and rejected outright if it would corrupt the file.

• skills/al-word-layout/SKILL.md — the companion skill: the intended agent workflow (inspect → edit → validate → preview → sandbox verify).
• skills/al-word-layout-design/SKILL.md — the design skill: what a new layout should look like — archetype skeletons and observed BC document conventions, each tagged with the stock corpus layout or BC-verified build it comes from.
• skills/al-word-layout-from-design/SKILL.md — from a finished Word design plus the report’s empty layout to a bound layout: what to ask a consultant for, mapping sample text to dataset fields, binding it, checking it.
• skills/al-word-layout-composite/SKILL.md — composable layouts: what the body, header/footer and theme files contain, and the style contract between them.
• docs/SOLUTION-DESIGN.md — architecture and design rationale.
• docs/adr/ — the deliberate design decisions, as ADRs.

Install

The server reads and writes layout files with your own permissions, at paths the calling agent supplies — point it only at repositories and layouts you trust, as you would any local build tool.

Option A — NuGet package via dnx (needs the .NET 10 SDK)

The .NET 10 SDK ships dnx, which fetches and runs the packaged server on demand — no install step, version-pinnable.

VS Code (.vscode/mcp.json, or user-level mcp.json):

{
  "servers": {
    "bc-word-layout": {
      "type": "stdio",
      "command": "dnx",
      "args": ["BcWordLayout.Mcp", "--yes"]
    }
  }
}

Claude Code (.mcp.json in a project, or user scope via the one-liner):

{
  "mcpServers": {
    "bc-word-layout": {
      "command": "dnx",
      "args": ["BcWordLayout.Mcp", "--yes"]
    }
  }
}

claude mcp add bc-word-layout -- dnx BcWordLayout.Mcp --yes