Aigroup Mdtoword MCP

What aigroup-mdtoword-mcp does

The aigroup-mdtoword-mcp MCP server provides two document-oriented tools. markdown_to_docx accepts Markdown text or a Markdown file and creates a .docx output. table_data_to_markdown accepts CSV or JSON tabular data and returns a formatted Markdown table.

The conversion path supports common Markdown structures, including headings, paragraphs, lists, code blocks, blockquotes, and tables. Documents can also include inline or block mathematical formulas, local or remote images, and Mermaid diagrams. Mermaid content can be rendered, with a code-block fallback when rendering is not available.

Document presentation can be controlled through style configuration. Supported layout options include fonts, colors, page settings, heading and paragraph styles, table formatting, image sizing and placement, and code-block appearance. The server also supports headers, footers, page numbers, and watermarks.

How it works

The aigroup-mdtoword-mcp MCP server is started as a local Node.js process and communicates with an MCP-compatible client. A client can invoke markdown_to_docx with Markdown content or an inputPath, along with values such as filename, outputPath, and styleConfig. The table tool accepts data, a format identifier, a style, and a hasHeader option.

The package can be launched directly with npx -y aigroup-mdtoword-mcp, or built from a cloned repository with npm. The documented runtime requirements are Node.js 18 or newer and npm 8 or newer. The server can also be started through an HTTP command, with documented routes including /health, /mcp, and /convert. Cloudflare Worker deployment is described as another option.

Setup and configuration

For a quick local setup, run the package through npx. For a local checkout, install dependencies, build the project, and start it:

npm install
npm run build
npm start

An MCP client using the package entry point can configure the server with npx and the -y argument. A locally built installation can instead invoke dist/index.js with Node.js. The README specifically provides a Claude Desktop configuration and describes the same approach as suitable for compatible MCP clients.

The project includes reusable templates for customer analysis, academic, business, technical, and minimal documents. It also publishes style-guide resources and conversion or memory metrics resources. These resources can help clients select a document style or inspect server-related information, although the two listed MCP tools are the main conversion interface.

Tools and capabilities

• markdown_to_docx: Creates a Word document from Markdown text or a file path.
• table_data_to_markdown: Converts CSV or JSON tabular input into a Markdown table.
• Template-based document styles for several report types.
• Formatting for tables, formulas, images, Mermaid diagrams, code, headings, lists, and blockquotes.
• Page-level features including headers, footers, page numbers, and watermarks.
• Optional HTTP deployment with MCP and conversion endpoints.

The project is released under the MIT License. Its documentation also notes that the software is provided without warranty and that users are responsible for their own security review, compliance, and downstream use.