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 協議驅動的專業文檔轉換工具。