AI Group Markdown to Word MCP Server

Professional Markdown-to-Word conversion over MCP, with advanced styling, tables, formulas, images, Mermaid rendering, and HTTP deployment support.

Overview

aigroup-mdtoword-mcp is an MCP server for generating professional .docx documents from Markdown content.

It is designed for:

converting Markdown into structured Word documents
applying reusable templates and styling presets
rendering tables, formulas, images, and Mermaid diagrams
exposing both MCP and simplified HTTP endpoints
integrating with Claude Desktop and other MCP-compatible clients

Highlights

Markdown to DOCX conversion with document styling and layout control
Advanced formatting for headings, tables, lists, code blocks, and blockquotes
Math support for inline and block formulas
Image embedding for local and remote assets
Mermaid rendering with safe fallback to code blocks
Header / footer / page numbering / watermark support
Template, resource, and prompt support for guided usage
HTTP deployment options including Cloudflare Worker workflows

Quick Start

Requirements

Node.js >= 18
npm >= 8

Run with npx

npx -y aigroup-mdtoword-mcp

Install locally

git clone https://github.com/jackdark425/aigroup-mdtoword-mcp.git
cd aigroup-mdtoword-mcp
npm install
npm run build
npm start

MCP Client Configuration

Claude Desktop / compatible MCP clients

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "npx",
      "args": ["-y", "aigroup-mdtoword-mcp"]
    }
  }
}

Local build output

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "node",
      "args": ["/path/to/aigroup-mdtoword-mcp/dist/index.js"]
    }
  }
}

Tools

`markdown_to_docx`

Converts Markdown content or a Markdown file into a .docx document.

Typical inputs include:

markdown
inputPath
filename
outputPath
styleConfig

`table_data_to_markdown`

Converts CSV or JSON tabular data into formatted Markdown tables.

Typical inputs include:

data
format
style
hasHeader

Resources

Templates

template://customer-analysis
template://academic
template://business
template://technical
template://minimal

Style Guides

style-guide://quick-start
style-guide://advanced
style-guide://templates

Metrics

metrics://conversion-stats
metrics://memory-usage

Styling Capabilities

The styling system supports:

document-level fonts, colors, and page layout
heading and paragraph styles
table presets and formatting
image sizing and placement
code block styling
headers, footers, page numbers, and watermarks

Included table styles cover common business, academic, financial, technical, and minimal report layouts.

Example

# Project Report

## Executive Summary
This is a sample report with **bold text** and *italic text*.

- Feature 1: Complete Markdown support
- Feature 2: Advanced styling system
- Feature 3: Professional document layout

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Data 1   | Data 2   | Data 3   |
| Data 4   | Data 5   | Data 6   |

Mathematical formula: $E = mc^2$

```mermaid
flowchart TD
  A[Start] --> B{Check input}
  B -->|Valid| C[Generate DOCX]
  B -->|Invalid| D[Return error]
```

Deployment

HTTP server

npm run server:http

Cloudflare Worker

npm install -g wrangler
wrangler login
wrangler deploy

Related endpoints typically include:

/health
/mcp
/convert
/.well-known/ai-plugin.json
/openapi.yaml
/openapi.json

See detailed guidance in docs/DEPLOYMENT_INSTRUCTIONS.md.

Project Structure

src/
├── index.ts
├── converter/
├── template/
├── types/
└── utils/

Development

npm run build
npm test

Additional test commands:

npm run test:math
npm run test:images
npm run test:pages
npm run test:mermaid

License & Usage

This project is released under the MIT License.

In practical terms, MIT allows you to:

use this project in personal, internal, academic, or commercial scenarios
copy, modify, merge, publish, and distribute the code
build proprietary or open-source products on top of it
ship derivative works as long as the required copyright and license notice is preserved

Please keep in mind:

you must retain the original copyright notice and MIT license text in copies or substantial portions of the software
the software is provided "AS IS", without warranty of any kind
if you package this project into hosted services, desktop tools, plugins, or internal workflows, you are responsible for your own compliance, security review, and downstream usage constraints

See the full text in LICENSE.

Acknowledgments

Core Dependencies & Ecosystem

Model Context Protocol SDK
- Repository: https://github.com/modelcontextprotocol/servers
- Role: MCP server protocol integration
docx by Dolan Miu
- Repository: https://github.com/dolanmiu/docx
- Role: core Word document generation engine

Community Inspiration

Inspired by the broader MCP community and ecosystem

Support

Issues: https://github.com/jackdark425/aigroup-mdtoword-mcp/issues
Documentation: https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/docs
Examples: https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/examples