Skip to main content
Glama
jackdark425

AI Group Markdown to Word MCP Server

by jackdark425

AI Group Markdown to Word MCP Server

License: MIT Node.js Version MCP Protocol

A comprehensive Model Context Protocol (MCP) server for converting Markdown documents to professional Word documents with advanced formatting, styling, and layout capabilities.

๐ŸŒŸ Features

Core Conversion

  • Full Markdown Support: Complete Markdown syntax including headings, paragraphs, lists, tables, code blocks, and blockquotes

  • Advanced Styling System: Comprehensive style configuration with themes, templates, and custom styling

  • Professional Document Layout: Page setup, margins, orientation, and document structure

Advanced Features

  • Mathematical Formulas: LaTeX math formula support with inline and block rendering

  • Table Processing: Advanced table styling with 12+ preset styles, CSV/JSON data import

  • Image Support: Local and remote image embedding with automatic scaling and formatting

  • Header & Footer: Complete header/footer system with page numbers, total pages, and custom content

  • Table of Contents: Automatic TOC generation with configurable levels and styling

  • Watermarks: Text watermarks with configurable position, rotation, and transparency

MCP Integration

  • Multiple Transports: Support for STDIO and Streamable HTTP transports

  • Tool-based Interface: Clean MCP tool interface for document conversion

  • Resource Templates: Pre-built document templates for various use cases

  • Prompt System: Intelligent prompts for user guidance and troubleshooting

HTTP API & OpenAI Plugin Support

  • Dual API Support: Both MCP protocol and simplified HTTP API endpoints

  • OpenAI Plugin Compatible: Full OpenAI plugin specification support

  • RESTful Endpoints: Simple REST API for easy integration

  • OpenAPI Specification: YAML and JSON API documentation available

๐Ÿš€ 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"] } } }

๐Ÿ› ๏ธ Available Tools

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 }

๐Ÿ“š 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: Color and font variables for consistent branding

  • Header/Footer: Custom headers and footers with page numbers

  • Watermarks: Text watermarks for document protection

  • Table Styling: 12+ preset table styles with zebra striping

  • Mathematical Formulas: 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

โ˜๏ธ Cloudflare Worker Deployment

This project supports deployment to Cloudflare Workers. Follow these steps to deploy:

Prerequisites

  1. Install Node.js (version >= 18.0.0)

  2. Install Wrangler CLI: npm install -g wrangler

  3. Login to Cloudflare: wrangler login

Deployment Steps

  1. Update wrangler.toml with your account ID:

    [env.production] account_id = "your-account-id-here" # Replace with your Cloudflare account ID
  2. Deploy to Cloudflare Workers:

    wrangler deploy

API Endpoints

After deployment, your service will be accessible via:

  • https://your-worker.your-subdomain.workers.dev/ - Main info page

  • https://your-worker.your-subdomain.workers.dev/health - Health check

  • https://your-worker.your-subdomain.workers.dev/mcp - MCP protocol endpoint

  • https://your-worker.your-subdomain.workers.dev/convert - Simplified HTTP API

  • https://your-worker.your-subdomain.workers.dev/.well-known/ai-plugin.json - OpenAI plugin manifest

  • https://your-worker.your-subdomain.workers.dev/openapi.yaml - OpenAPI specification (YAML)

  • https://your-worker.your-subdomain.workers.dev/openapi.json - OpenAPI specification (JSON)

  • https://your-worker.your-subdomain.workers.dev/logo.png - Plugin logo

For detailed deployment instructions, see docs/DEPLOYMENT_INSTRUCTIONS.md.

๐Ÿ“ž Support


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

Install Server
A
security โ€“ no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jackdark425/aigroup-mdtoword-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server