MCP Md Mmd Pdf

🚀 Markdown + Mermaid 轉 PDF MCP 服務器

這是一個 MCP（模型上下文協議）服務器，它可以將包含 Mermaid 圖表的 Markdown 文件轉換為 PDF 文檔，還能將獨立的 Mermaid 圖表轉換為 PNG 或 PDF 格式。該服務器採用混合方法：先將 Markdown 轉換為 HTML，把 Mermaid 圖表渲染為 SVG 圖形，然後使用 Puppeteer 生成輸出文件。

✨ 主要特性

• 將包含 Mermaid 圖表的 Markdown 文件轉換為 PDF
• 將獨立的 Mermaid 圖表代碼轉換為 PNG 圖像
• 將獨立的 Mermaid 圖表代碼轉換為 PDF 文件
• 自動將 Mermaid 圖表渲染為高質量的 SVG 圖形
• 擁有簡潔、專業的默認樣式
• 支持自定義 CSS 樣式（用於 Markdown 轉換）
• 具備簡單的 MCP 工具界面

📦 安裝指南

npm install
npm run build

💻 使用示例

作為 MCP 服務器

將此服務器添加到您的 MCP 客戶端配置（例如，Claude Desktop）中：

{
  "mcpServers": {
    "md-mmd-pdf": {
      "command": "node",
      "args": ["/absolute/path/to/md-mmd-pdf/build/index.js"]
    }
  }
}

工具：convert_md_to_pdf

將包含 Mermaid 圖表的 Markdown 文件轉換為 PDF。

參數：

• input_path（必需）：輸入 Markdown 文件的絕對路徑
• output_path（可選）：PDF 文件的保存絕對路徑。如果未提供，則使用與輸入文件相同的名稱，擴展名為 .pdf
• custom_css（可選）：應用於 PDF 的額外 CSS 樣式

示例：

{
  "input_path": "/path/to/document.md",
  "output_path": "/path/to/output.pdf"
}

工具：convert_mermaid_to_png

將獨立的 Mermaid 圖表代碼轉換為 PNG 圖像文件。

參數：

• mermaid_code（必需）：原始 Mermaid 圖表代碼字符串
• output_path（必需）：PNG 文件的保存絕對路徑

示例：

{
  "mermaid_code": "graph TD\n  A[Start] --> B[Process]\n  B --> C[End]",
  "output_path": "/path/to/diagram.png"
}

工具：convert_mermaid_to_pdf

將獨立的 Mermaid 圖表代碼轉換為 PDF 文件。

參數：

• mermaid_code（必需）：原始 Mermaid 圖表代碼字符串
• output_path（必需）：PDF 文件的保存絕對路徑

示例：

{
  "mermaid_code": "sequenceDiagram\n  Alice->>Bob: Hello\n  Bob->>Alice: Hi!",
  "output_path": "/path/to/diagram.pdf"
}

📚 詳細文檔

工作原理

1. Markdown 解析：使用 marked 庫讀取並解析 Markdown 內容。
2. HTML 生成：將 Markdown 轉換為 HTML，同時保留 Mermaid 代碼塊。
3. Mermaid 渲染：注入 Mermaid.js 庫，在瀏覽器中將圖表渲染為 SVG。
4. PDF 導出：使用 Puppeteer（無頭 Chrome）生成包含所有渲染內容的最終 PDF。

示例 Markdown 文件

查看 example.md 可獲取包含 Mermaid 圖表的示例文檔。

開發步驟

# 安裝依賴
npm install

# 構建項目
npm run build

# 開發模式下的監聽模式
npm run dev

# 啟動服務器
npm start

運行要求

• Node.js 18 或更高版本
• 足夠的內存以支持 Puppeteer 運行無頭 Chrome

📄 許可證

本項目採用 MIT 許可證。