Aigroup Mdtoword MCP

🚀 AI Group Markdown to Word MCP Server

This is a comprehensive Model Context Protocol (MCP) server that can convert Markdown documents into professional Word documents. It is equipped with advanced formatting, styling, and layout capabilities, providing users with high - quality document conversion services.

🚀 Quick Start

Installation

# Using npx (recommended for one - time use)
npx -y aigroup-mdtoword-mcp

# Or install globally
npm install -g aigroup-mdtoword-mcp

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

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

Usage with Other MCP Clients

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

✨ Features

Core Conversion

• Full Markdown Support: It supports the complete Markdown syntax, including headings, paragraphs, lists, tables, code blocks, and blockquotes.
• Advanced Styling System: It offers a comprehensive style configuration with themes, templates, and custom styling options.
• Professional Document Layout: It allows for page setup, margins, orientation, and document structure customization.

Advanced Features

• Mathematical Formulas: It supports LaTeX math formulas with inline and block rendering.
• Table Processing: It provides advanced table styling with over 12 preset styles and supports CSV/JSON data import.
• Image Support: It enables local and remote image embedding with automatic scaling and formatting.
• Header & Footer: It has a complete header/footer system with page numbers, total pages, and custom content.
• Table of Contents: It can automatically generate a table of contents with configurable levels and styling.
• Watermarks: It supports text watermarks with configurable position, rotation, and transparency.

MCP Integration

• Multiple Transports: It supports STDIO and Streamable HTTP transports.
• Tool - based Interface: It has a clean MCP tool interface for document conversion.
• Resource Templates: It provides pre - built document templates for various use cases.
• Prompt System: It offers intelligent prompts for user guidance and troubleshooting.

💻 Usage Examples

markdown_to_docx

Convert Markdown content to Word document with full styling support.

Input Schema:

{
  markdown?: string;           // Markdown content (required if inputPath not provided)
  inputPath?: string;          // Path to Markdown file
  filename: string;            // Output filename (without extension)
  outputPath?: string;         // Custom output directory
  styleConfig?: StyleConfig;   // Advanced styling configuration
}

Example Usage:

Convert this markdown to a Word document:

# 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$

table_data_to_markdown

Convert structured data (CSV/JSON) to formatted Markdown tables.

Input Schema:

{
  data: string;                // CSV or JSON data
  format: 'csv' | 'json';      // Data format
  style?: string;              // Table style preset
  hasHeader?: boolean;         // Whether data includes headers
}

📚 Documentation

Available Resources

Templates

• template://customer-analysis - Business analysis report template
• template://academic - Academic paper template
• template://business - Professional business report
• template://technical - Technical documentation
• template://minimal - Clean minimal template

Style Guides

• style-guide://quick-start - Quick styling reference
• style-guide://advanced - Advanced styling options
• style-guide://templates - Template usage guide

Performance Metrics

• metrics://conversion-stats - Conversion performance data
• metrics://memory-usage - Memory usage statistics

Styling System

Basic Styling

{
  document: {
    defaultFont: "宋体",
    defaultSize: 24,
    defaultColor: "000000",
    page: {
      size: "A4",
      orientation: "portrait",
      margins: { top: 1440, bottom: 1440, left: 1440, right: 1440 }
    }
  },
  headingStyles: {
    h1: { font: "黑体", size: 64, color: "000000", bold: true },
    h2: { font: "黑体", size: 32, color: "000000", bold: true }
  }
}

Advanced Features

• Theme System: It uses color and font variables for consistent branding.
• Header/Footer: It supports custom headers and footers with page numbers.
• Watermarks: It offers text watermarks for document protection.
• Table Styling: It has over 12 preset table styles with zebra striping.
• Mathematical Formulas: It provides professional math formula rendering.

Table Styles

The server includes 12 professionally designed table styles:

1. minimal - Clean modern style with thin borders
2. professional - Business style with dark headers
3. striped - Zebra striping for better readability
4. grid - Complete grid borders for structured data
5. elegant - Double borders for formal documents
6. colorful - Colorful headers for vibrant presentations
7. compact - Minimal margins for data - dense tables
8. fresh - Green theme for environmental reports
9. tech - Blue tech theme for technical documents
10. report - Formal report style with double borders
11. financial - Right - aligned numbers for financial data
12. academic - Academic paper style

Configuration

Style Configuration

Full style configuration supports:

• Document - level settings (fonts, colors, page setup)
• Paragraph and heading styles
• Table and list formatting
• Image and code block styling
• Header/footer configuration
• Watermark settings

Transport Options

• STDIO: Standard input/output for local execution
• Streamable HTTP: HTTP transport for remote servers

Project Structure

src/
├── index.ts                 # Main MCP server implementation
├── converter/
│   └── markdown.ts         # Markdown to DOCX converter
├── template/
│   └── presetLoader.ts     # Template system
├── types/
│   ├── index.ts           # Core types
│   ├── style.ts          # Style configuration types
│   └── template.ts       # Template types
└── utils/
    ├── tableProcessor.ts  # Table processing utilities
    ├── mathProcessor.ts   # Mathematical formula processing
    ├── imageProcessor.ts  # Image handling utilities
    ├── styleEngine.ts     # Style application engine
    └── errorHandler.ts    # Error handling utilities

Testing

Run the test suite:

npm test

Available test scenarios:

• Mathematical formula conversion
• Local image embedding
• Page numbering and headers/footers
• Table styling and data import
• Complete document conversion

Performance

• Fast Conversion: Optimized processing for large documents
• Memory Efficient: Stream - based processing for minimal memory usage
• Production Ready: Robust error handling and logging
• Scalable: Handles documents of any size efficiently

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built with the Model Context Protocol SDK
• Uses docx for Word document generation
• Inspired by the MCP community and ecosystem

📞 Support

• Issues: GitHub Issues
• Documentation: Full Documentation
• Examples: Example Files

AI Group Markdown to Word MCP Server - Professional document conversion powered by MCP protocol.