aigroup-mdtoword-mcp

AI Group Markdown 转 Word MCP 服务

通过 MCP 将 Markdown 专业地转换为 Word，支持高级样式、表格、公式、图片、Mermaid 渲染和 HTTP 部署。

概述

aigroup-mdtoword-mcp 是一个 MCP 服务，可根据 Markdown 内容生成专业的 .docx 文档。

适用于：

• 将 Markdown 转换为结构化的 Word 文档
• 应用可重复使用的模板和样式预设
• 渲染表格、公式、图片和 Mermaid 图表
• 同时提供 MCP 和简化的 HTTP 端点
• 与 Claude Desktop 及其他兼容 MCP 的客户端集成

亮点

• Markdown 转 DOCX，支持文档样式和布局控制
• 高级格式设置，支持标题、表格、列表、代码块和引用块
• 数学公式支持，支持行内公式和块级公式
• 图片嵌入，支持本地和远程资源
• Mermaid 渲染，失败时安全回退为代码块
• 支持页眉 / 页脚 / 页码 / 水印
• 支持模板、资源和提示词，助力引导式使用
• HTTP 部署选项，包括 Cloudflare Worker 工作流

快速开始

要求

• Node.js >= 18
• npm >= 8

使用 npx 运行

npx -y aigroup-mdtoword-mcp

本地安装

git clone https://github.com/jackdark425/aigroup-mdtoword-mcp.git
cd aigroup-mdtoword-mcp
npm install
npm run build
npm start

MCP 客户端配置

Claude Desktop / 兼容 MCP 的客户端

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

本地构建输出

{
  "mcpServers": {
    "markdown-to-word": {
      "command": "node",
      "args": ["/path/to/aigroup-mdtoword-mcp/dist/index.js"]
    }
  }
}

工具

markdown_to_docx

将 Markdown 内容或 Markdown 文件转换为 .docx 文档。

常见输入包括：

• markdown
• inputPath
• filename
• outputPath
• styleConfig

table_data_to_markdown

将 CSV 或 JSON 表格数据转换为格式化的 Markdown 表格。

常见输入包括：

• data
• format
• style
• hasHeader

资源

模板

• template://customer-analysis
• template://academic
• template://business
• template://technical
• template://minimal

样式指南

• style-guide://quick-start
• style-guide://advanced
• style-guide://templates

指标

• metrics://conversion-stats
• metrics://memory-usage

样式功能

样式系统支持：

• 文档级字体、颜色和页面布局
• 标题和段落样式
• 表格预设和格式设置
• 图片尺寸和位置
• 代码块样式
• 页眉、页脚、页码和水印

内置表格样式涵盖常见的商业、学术、财务、技术和简约报告布局。

示例

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

```mermaid
flowchart TD
  A[Start] --> B{Check input}
  B -->|Valid| C[Generate DOCX]
  B -->|Invalid| D[Return error]
```

部署

HTTP 服务

npm run server:http

Cloudflare Worker

npm install -g wrangler
wrangler login
wrangler deploy

相关端点通常包括：

• /health
• /mcp
• /convert
• /.well-known/ai-plugin.json
• /openapi.yaml
• /openapi.json

请参阅 docs/DEPLOYMENT_INSTRUCTIONS.md 中的详细指南。

项目结构

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

开发

npm run build
npm test

其他测试命令：

• npm run test:math
• npm run test:images
• npm run test:pages
• npm run test:mermaid

许可证与使用

本项目根据 MIT 许可证 发布。

实际上，MIT 许可证允许你：

• 在个人、内部、学术或商业场景中使用本项目
• 复制、修改、合并、发布和分发代码
• 基于本项目构建专有产品或开源产品
• 发布衍生作品，前提是保留所需的版权声明和许可证声明

请注意：

• 你必须在软件副本或软件的实质性部分中保留原始版权声明和 MIT 许可证文本
• 本软件按“原样”提供，不提供任何形式的担保
• 如果你将本项目打包到托管服务、桌面工具、插件或内部工作流中，你需要自行负责合规性、安全审查以及下游使用限制

请参阅 LICENSE 中的完整文本。

致谢

核心依赖项与生态系统

• Model Context Protocol SDK

  • 仓库：https://github.com/modelcontextprotocol/servers
  • 作用：MCP 服务协议集成

• Dolan Miu 开发的 docx

  • 仓库：https://github.com/dolanmiu/docx
  • 作用：核心 Word 文档生成引擎

社区启发

• 灵感来自更广泛的 MCP 社区和生态系统

支持

• 问题反馈：https://github.com/jackdark425/aigroup-mdtoword-mcp/issues
• 文档：https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/docs
• 示例：https://github.com/jackdark425/aigroup-mdtoword-mcp/tree/main/examples