Aigroup Mdtoword Mcp

io.github.jackdark425Published by GitHub account jackdark425v4.0.2Updated Oct 24, 2026

本地 Markdown 到 Word 文档转换工具，支持最新 MCP 协议特性、完整的页眉页脚页码功能、增强的表格功能、数据导入和数学公式支持，修复本地相对路径图片嵌入问题

VerifiedSTDIODesktop onlyProductivity & WorkflowFiles & Storage

Overview

AI-generated overview

Converts Markdown content or files into styled Word .docx documents, including tables, formulas, images, and Mermaid diagrams.

What you can do
This local MCP server generates professional .docx documents from Markdown. Its main tool, markdown_to_docx, accepts Markdown text or a file path plus a filename, output path, and style configuration, and applies templates, heading and paragraph styles, table presets, image sizing, code block styling, and headers, footers, page numbers, and watermarks. A second tool, table_data_to_markdown, turns CSV or JSON tabular data into formatted Markdown tables. It also exposes template, style-guide, and metrics resources.
When to use it
Useful when an assistant needs to produce Word deliverables from Markdown, such as reports, academic papers, or business documents, and when consistent styling, tables, formulas, or diagrams matter. It is a local desktop-oriented tool rather than a hosted service.
Requirements
Runs locally over stdio as an npm package (aigroup-mdtoword-mcp). Requires Node.js 18 or later and npm 8 or later; it can be started with npx or from a local build. No authentication, environment variables, or headers are declared.
Before you install
The server writes .docx files to paths supplied in tool inputs, so output locations should be chosen deliberately. It can embed local and remote images, which may cause it to read local files or fetch remote assets. The README also mentions optional HTTP and Cloudflare Worker deployment; that is outside the default local stdio setup.

Installation

In SourceWeft

  1. Open Aigroup Mdtoword Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

AI Group Markdown to Word MCP Server

[License: MIT] [Node.js] [MCP Protocol] [Version]

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

bash
npx -y aigroup-mdtoword-mcp

Install locally

bash
git clone https://github.com/jackdark425/aigroup-mdtoword-mcp.gitcd aigroup-mdtoword-mcpnpm installnpm run buildnpm start

MCP Client Configuration

Claude Desktop / compatible MCP clients

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

Local build output

json
{  "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

markdown
# Project Report
## Executive SummaryThis 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$
```mermaidflowchart TD  A[Start] --> B{Check input}  B -->|Valid| C[Generate DOCX]  B -->|Invalid| D[Return error]```

Deployment

HTTP server

bash
npm run server:http

Cloudflare Worker

bash
npm install -g wranglerwrangler loginwrangler 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

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

Development

bash
npm run buildnpm 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

Community Inspiration

  • Inspired by the broader MCP community and ecosystem

Support

Source: README.md at commit 7a0b784

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v4.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts