{
  "markdown": "# AI Group Markdown to Word MCP Server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)\n[![MCP Protocol](https://img.shields.io/badge/MCP-Protocol-blue.svg)](https://modelcontextprotocol.io)\n[![Version](https://img.shields.io/badge/version-4.0.2-brightgreen.svg)](https://github.com/jackdark425/aigroup-mdtoword-mcp)\n\n> Professional Markdown-to-Word conversion over MCP, with advanced styling, tables, formulas, images, Mermaid rendering, and HTTP deployment support.\n\n## Overview\n\n`aigroup-mdtoword-mcp` is an MCP server for generating professional `.docx` documents from Markdown content.\n\nIt is designed for:\n\n- converting Markdown into structured Word documents\n- applying reusable templates and styling presets\n- rendering tables, formulas, images, and Mermaid diagrams\n- exposing both MCP and simplified HTTP endpoints\n- integrating with Claude Desktop and other MCP-compatible clients\n\n## Highlights\n\n- **Markdown to DOCX conversion** with document styling and layout control\n- **Advanced formatting** for headings, tables, lists, code blocks, and blockquotes\n- **Math support** for inline and block formulas\n- **Image embedding** for local and remote assets\n- **Mermaid rendering** with safe fallback to code blocks\n- **Header / footer / page numbering / watermark support**\n- **Template, resource, and prompt support** for guided usage\n- **HTTP deployment options** including Cloudflare Worker workflows\n\n## Quick Start\n\n### Requirements\n\n- Node.js >= 18\n- npm >= 8\n\n### Run with npx\n\n```bash\nnpx -y aigroup-mdtoword-mcp\n```\n\n### Install locally\n\n```bash\ngit clone https://github.com/jackdark425/aigroup-mdtoword-mcp.git\ncd aigroup-mdtoword-mcp\nnpm install\nnpm run build\nnpm start\n```\n\n## MCP Client Configuration\n\n### Claude Desktop / compatible MCP clients\n\n```json\n{\n  \"mcpServers\": {\n    \"markdown-to-word\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"aigroup-mdtoword-mcp\"]\n    }\n  }\n}\n```\n\n### Local build output\n\n```json\n{\n  \"mcpServers\": {\n    \"markdown-to-word\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/aigroup-mdtoword-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n## Tools\n\n### `markdown_to_docx`\nConverts Markdown content or a Markdown file into a `.docx` document.\n\nTypical inputs include:\n\n- `markdown`\n- `inputPath`\n- `filename`\n- `outputPath`\n- `styleConfig`\n\n### `table_data_to_markdown`\nConverts CSV or JSON tabular data into formatted Markdown tables.\n\nTypical inputs include:\n\n- `data`\n- `format`\n- `style`\n- `hasHeader`\n\n## Resources\n\n### Templates\n- `template://customer-analysis`\n- `template://academic`\n- `template://business`\n- `template://technical`\n- `template://minimal`\n\n### Style Guides\n- `style-guide://quick-start`\n- `style-guide://advanced`\n- `style-guide://templates`\n\n### Metrics\n- `metrics://conversion-stats`\n- `metrics://memory-usage`\n\n## Styling Capabilities\n\nThe styling system supports:\n\n- document-level fonts, colors, and page layout\n- heading and paragraph styles\n- table presets and formatting\n- image sizing and placement\n- code block styling\n- headers, footers, page numbers, and watermarks\n\nIncluded table styles cover common business, academic, financial, technical, and minimal report layouts.\n\n## Example\n\n````markdown\n# Project Report\n\n## Executive Summary\nThis is a sample report with **bold text** and *italic text*.\n\n- Feature 1: Complete Markdown support\n- Feature 2: Advanced styling system\n- Feature 3: Professional document layout\n\n| Column 1 | Column 2 | Column 3 |\n|----------|----------|----------|\n| Data 1   | Data 2   | Data 3   |\n| Data 4   | Data 5   | Data 6   |\n\nMathematical formula: $E = mc^2$\n\n```mermaid\nflowchart TD\n  A[Start] --> B{Check input}\n  B -->|Valid| C[Generate DOCX]\n  B -->|Invalid| D[Return error]\n```\n````\n\n## Deployment\n\n### HTTP server\n\n```bash\nnpm run server:http\n```\n\n### Cloudflare Worker\n\n```bash\nnpm install -g wrangler\nwrangler login\nwrangler deploy\n```\n\nRelated endpoints typically include:\n\n- `/health`\n- `/mcp`\n- `/convert`\n- `/.well-known/ai-plugin.json`\n- `/openapi.yaml`\n- `/openapi.json`\n\nSee detailed guidance in [docs/DEPLOYMENT_INSTRUCTIONS.md](docs/DEPLOYMENT_INSTRUCTIONS.md).\n\n## Project Structure\n\n```text\nsrc/\n├── index.ts\n├── converter/\n├── template/\n├── types/\n└── utils/\n```\n\n## Development\n\n```bash\nnpm run build\nnpm test\n```\n\nAdditional test commands:\n\n- `npm run test:math`\n- `npm run test:images`\n- `npm run test:pages`\n- `npm run test:mermaid`\n\n## License & Usage\n\nThis project is released under the **MIT License**.\n\nIn practical terms, MIT allows you to:\n\n- use this project in personal, internal, academic, or commercial scenarios\n- copy, modify, merge, publish, and distribute the code\n- build proprietary or open-source products on top of it\n- ship derivative works as long as the required copyright and license notice is preserved\n\nPlease keep in mind:\n\n- **you must retain** the original copyright notice and MIT license text in copies or substantial portions of the software\n- **the software is provided \"AS IS\"**, without warranty of any kind\n- 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\n\nSee the full text in [LICENSE](LICENSE).\n\n## Acknowledgments\n\n### Core Dependencies & Ecosystem\n\n- **Model Context Protocol SDK**\n  - Repository: https://github.com/modelcontextprotocol/servers\n  - Role: MCP server protocol integration\n\n- **docx** by **Dolan Miu**\n  - Repository: https://github.com/dolanmiu/docx\n  - Role: core Word document generation engine\n\n### Community Inspiration\n\n- Inspired by the broader MCP community and ecosystem\n\n## Support\n\n- Issues: https://github.com/jackdark425/aigroup-mdtoword-mcp/issues\n- Documentation: https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/docs\n- Examples: https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/examples\n",
  "bytes": 5994,
  "sha": "d3eb5f9a9b8929444554fe10ae324f51c9d1d93fa0bebcb62668a83986f9463e",
  "repo_slug": "jackdark425/aigroup-mdtoword-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jackdark425_aigroup_mdtoword_m_3206b112/readme"
}