Markdown2pdf MCP

🚀 Markdown2PDF MCP サーバー（markdown2pdf-mcp）

このサーバーは、MarkdownドキュメントをPDFファイルに変換するためのMCPサーバーです。MarkdownコンテンツからPDFを生成する簡単で効率的な方法を提供し、構文のハイライトやカスタムスタイルをサポートし、最初のページにウォーターマークを追加することができます。

このアイデアは、Alan Shawのmarkdown-pdfにインスパイアされています。

🚀 クイックスタート

Markdown2PDF MCPサーバーを使用することで、Markdownドキュメントを簡単にPDFに変換できます。以下の手順に従って、サーバーをセットアップして使用してください。

✨ 主な機能

• 単一のコマンドでMarkdownをPDFに変換
• コードブロックの構文ハイライト
• PDF出力のカスタムCSSスタイル
• 標準Markdown形式のサポート
• Chromeエンジンを使用した最新のPDF生成
• 最新のWeb機能とフォントの優れたサポート
• 信頼性の高いリソースの読み込みとレンダリング

🔧 注意事項

以下のMarkdown要素はサポートされていません：

• LaTeX数式（例：$x^2$ または $$\sum_{i=1}^n x_i$$）
• 複雑な数式や科学表記

以下のサポートされているMarkdown要素のみを使用してください：

• 見出し（すべてのレベル）
• テキストの書式設定（太字、斜体、取り消し線）
• リスト（順序付きと順序なし）
• 構文ハイライト付きのコードブロック
• 表
• 引用ブロック
• リンク
• 画像（ローカルファイルと外部URL）
• タスクリスト

📦 インストール

# リポジトリをクローンする
git clone https://github.com/2b3pro/markdown2pdf-mcp.git

# プロジェクトディレクトリに移動する
cd markdown2pdf-mcp

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

💻 使用例

サーバーの起動

npm start

MCPツールの使用

このサーバーは、単一のツールcreate_pdf_from_markdownを提供しており、以下のパラメータを持っています：

{
  // 必須パラメータ
  markdown: string;    // PDFに変換するMarkdownコンテンツ

  // オプションパラメータ、デフォルト値
  outputFilename?: string;  // PDFファイル名（例：“output.pdf”）
  paperFormat?: string;     // 'letter'（デフォルト）、'a4'、'a3'、'a5'、'legal'、'tabloid'
  paperOrientation?: string; // 'portrait'（デフォルト）または 'landscape'
  paperBorder?: string;     // '2cm'（デフォルト）、CSS単位付きの10進数値を受け付ける（例：“1.5cm”、“2.5mm”、“0.5in”、“10.5px”）
  watermark?: string;       // オプションのウォーターマークテキスト（最大10文字）
}

サンプル

// サーバーを起動する
npm start

// MCPツールの使用例
{
  "command": "create_pdf_from_markdown",
  "params": {
    "markdown": "# 私の最初のPDF\nこれは**Markdown**をPDFに変換するコンバーターです。",
    "outputFilename": "example.pdf"
  }
}

📚 ドキュメント

出力ディレクトリの設定

デフォルトの出力ディレクトリ（./dist）を変更するには、プロジェクトのルートディレクトリに.envファイルを作成し、以下の内容を追加してください：

OUTPUT_DIR=your_desired_directory

依存関係

• pdfmake - PDF生成に主に使用
• jsdom - Markdownのレンダリングに使用
• marked - Markdown解析器

Chromeバージョン

pdfmakeはChrome Blinkエンジンに依存しているため、最新バージョンのChromeブラウザをインストールすることをおすすめします。

開発ガイド

1. 依存関係をインストールする：npm install
2. 開発サーバーを起動する：npm start

📄 ライセンス

MIT

🔗 貢献ガイド

1. リポジトリをForkする
2. 機能ブランチを作成する（git checkout -b feature/amazing-feature）
3. 変更をコミットする（git commit -m 'いくつかの素敵な機能を追加'）
4. ブランチにプッシュする（git push origin feature/amazing-feature）
5. Pull Requestを開く