Aigroup Mdtoword MCP

🚀 AI Group Markdown 转 Word MCP 服务器

这是一个全面的模型上下文协议（MCP）服务器，用于将 Markdown 文档转换为具有高级格式、样式和布局功能的专业 Word 文档。

🚀 快速开始

安装

# 使用 npx（推荐一次性使用）
npx -y aigroup-mdtoword-mcp

# 或者全局安装
npm install -g aigroup-mdtoword-mcp

在 Claude Desktop 中使用

将以下内容添加到你的 Claude Desktop 配置文件（claude_desktop_config.json）中：

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

在其他 MCP 客户端中使用

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

✨ 主要特性

核心转换功能

• 全面的 Markdown 支持：支持完整的 Markdown 语法，包括标题、段落、列表、表格、代码块和块引用。
• 高级样式系统：提供全面的样式配置，支持主题、模板和自定义样式。
• 专业文档布局：支持页面设置、页边距、页面方向和文档结构设置。

高级特性

• 数学公式：支持 LaTeX 数学公式，可进行内联和块级渲染。
• 表格处理：提供 12 种以上预设样式的高级表格样式，支持 CSV/JSON 数据导入。
• 图像支持：支持嵌入本地和远程图像，并自动进行缩放和格式化。
• 页眉页脚：提供完整的页眉页脚系统，支持页码、总页数和自定义内容。
• 目录：可自动生成目录，支持配置目录级别和样式。
• 水印：支持文本水印，可配置水印位置、旋转角度和透明度。

MCP 集成

• 多种传输方式：支持 STDIO 和可流式传输的 HTTP 传输方式。
• 基于工具的接口：提供简洁的 MCP 工具接口，用于文档转换。
• 资源模板：提供多种用例的预建文档模板。
• 提示系统：智能提示功能，为用户提供指导和故障排除帮助。

📦 安装指南

安装命令

# 使用 npx（推荐一次性使用）
npx -y aigroup-mdtoword-mcp

# 或者全局安装
npm install -g aigroup-mdtoword-mcp

💻 使用示例

markdown_to_docx

将 Markdown 内容转换为支持完整样式的 Word 文档。

输入模式：

{
  markdown?: string;           // Markdown 内容（如果未提供 inputPath，则为必需项）
  inputPath?: string;          // Markdown 文件路径
  filename: string;            // 输出文件名（不包含扩展名）
  outputPath?: string;         // 自定义输出目录
  styleConfig?: StyleConfig;   // 高级样式配置
}

使用示例：

将以下 Markdown 转换为 Word 文档：

# 项目报告
## 执行摘要
这是一份包含 **粗体文本** 和 *斜体文本* 的示例报告。

- 特性 1：全面的 Markdown 支持
- 特性 2：高级样式系统
- 特性 3：专业文档布局

| 列 1 | 列 2 | 列 3 |
|----------|----------|----------|
| 数据 1 | 数据 2 | 数据 3 |
| 数据 4 | 数据 5 | 数据 6 |

数学公式：$E = mc^2$

table_data_to_markdown

将结构化数据（CSV/JSON）转换为格式化的 Markdown 表格。

输入模式：

{
  data: string;                // CSV 或 JSON 数据
  format: 'csv' | 'json';      // 数据格式
  style?: string;              // 表格样式预设
  hasHeader?: boolean;         // 数据是否包含标题
}

📚 详细文档

可用资源

模板

• 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 - 内存使用统计

样式系统

基本样式

{
  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 }
  }
}

高级特性

• 主题系统：支持颜色和字体变量，实现一致的品牌风格。
• 页眉页脚：支持自定义页眉页脚，并显示页码。
• 水印：支持文本水印，用于文档保护。
• 表格样式：提供 12 种以上预设表格样式，支持斑马线效果。
• 数学公式：支持专业的数学公式渲染。

表格样式

服务器包含 12 种专业设计的表格样式：

1. minimal - 简洁现代风格，细边框
2. professional - 商务风格，深色标题
3. striped - 斑马线效果，提高可读性
4. grid - 完整网格边框，适用于结构化数据
5. elegant - 双边框，适用于正式文档
6. colorful - 彩色标题，适用于生动的演示文稿
7. compact - 最小页边距，适用于数据密集型表格
8. fresh - 绿色主题，适用于环境报告
9. tech - 蓝色科技主题，适用于技术文档
10. report - 正式报告风格，双边框
11. financial - 数字右对齐，适用于财务数据
12. academic - 学术论文风格

配置

样式配置

完整的样式配置支持：

• 文档级设置（字体、颜色、页面设置）
• 段落和标题样式
• 表格和列表格式
• 图像和代码块样式
• 页眉页脚配置
• 水印设置

传输选项

• STDIO：标准输入输出，适用于本地执行
• Streamable HTTP：HTTP 传输，适用于远程服务器

项目结构

src/
├── index.ts                 # 主 MCP 服务器实现
├── converter/
│   └── markdown.ts         # Markdown 转 DOCX 转换器
├── template/
│   └── presetLoader.ts     # 模板系统
├── types/
│   ├── index.ts           # 核心类型
│   ├── style.ts          # 样式配置类型
│   └── template.ts       # 模板类型
└── utils/
    ├── tableProcessor.ts  # 表格处理工具
    ├── mathProcessor.ts   # 数学公式处理工具
    ├── imageProcessor.ts  # 图像处理工具
    ├── styleEngine.ts     # 样式应用引擎
    └── errorHandler.ts    # 错误处理工具

测试

运行测试套件：

npm test

可用的测试场景：

• 数学公式转换
• 本地图像嵌入
• 页码和页眉页脚
• 表格样式和数据导入
• 完整文档转换

性能

• 快速转换：针对大文档进行了优化处理。
• 内存高效：基于流的处理方式，内存占用最小。
• 生产就绪：具备强大的错误处理和日志记录功能。
• 可扩展：可高效处理任意大小的文档。

🤝 贡献

我们欢迎贡献！请参阅我们的 贡献指南 了解详细信息。

1. 分叉仓库
2. 创建功能分支
3. 进行更改
4. 添加测试
5. 提交拉取请求

📄 许可证

本项目采用 MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• 基于 Model Context Protocol SDK 构建
• 使用 docx 进行 Word 文档生成
• 受 MCP 社区和生态系统的启发

📞 支持

• 问题反馈：GitHub Issues
• 文档：完整文档
• 示例文件：示例文件

AI Group Markdown 转 Word MCP 服务器 - 由 MCP 协议驱动的专业文档转换工具。