MCP Md Mmd Pdf

🚀 Markdown + Mermaid to PDF MCP Server

このサーバーは、MCP（Model Context Protocol）サーバーで、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生成: Mermaidコードブロックを保持したまま、MarkdownをHTMLに変換します。
3. Mermaidレンダリング: Mermaid.jsライブラリを注入して、ブラウザ内でダイアグラムをSVGとしてレンダリングします。
4. PDFエクスポート: Puppeteer（ヘッドレスChrome）を使用して、すべてのコンテンツがレンダリングされた最終的なPDFを生成します。

サンプルMarkdown

Mermaidダイアグラムを含むサンプルドキュメントはexample.mdを参照してください。

開発

# 依存関係のインストール
npm install

# ビルド
npm run build

# 開発用のウォッチモード
npm run dev

# サーバーの起動
npm start

必要条件

• Node.js 18以上
• PuppeteerがヘッドレスChromeを実行するのに十分なメモリ

📄 ライセンス

MIT