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 endpo

... View full README on GitHub