md2pdf-ja-mcp

md2pdf-ja 用の MCP (Model Context Protocol) サーバー - Claude Code から直接、日本語の Markdown ファイルを美しい PDF に変換します。

機能

• 🚀 Claude Code から Markdown を PDF に変換
• 🇯🇵 日本語文書に最適化
• 🎨 複数のテーマ（default、academic、business）
• 📄 カスタムページフォーマット（A4、A5、B5、Letter）
• 🎯 カスタム CSS サポート
• ⚡ 高速で効率的な変換

前提条件

この MCP サーバーを使用する前に、md2pdf-ja をインストールする必要があります：

npm install -g @j2masamitu/md2pdf-ja

インストール

オプション 1: npm（推奨）

npm install -g @j2masamitu/md2pdf-ja-mcp

オプション 2: ソースから

git clone https://github.com/j2masamitu/md2pdf-ja-mcp
cd md2pdf-ja-mcp
npm install
npm run build
npm link

設定

Claude Code の設定

claude mcp add md2pdf-ja-mcp md2pdf-ja-mcp --scope user

利用可能なツール

convert_markdown_to_pdf

日本語の Markdown ファイルを美しい PDF に変換します。

パラメータ：

• input（必須）：入力 Markdown ファイルへのパス
• output（オプション）：出力 PDF ファイルへのパス
• title（オプション）：文書のタイトル - 明示的に要求された場合のみ使用
• author（オプション）：文書の著者 - 明示的に要求された場合のみ使用
• theme（オプション）：テーマ（default、academic、business）- 明示的に要求された場合のみ使用
• format（オプション）：ページフォーマット（A4、A5、B5、Letter）- 明示的に要求された場合のみ使用
• css（オプション）：カスタム CSS ファイルへのパス - 明示的に要求された場合のみ使用

重要： デフォルトでは、input（およびオプションで output）パラメータのみを使用する必要があります。他のパラメータは、ユーザーが明示的に要求した場合にのみ含める必要があります。これにより、PDF 内のタイトルの重複や不要なメタデータを防ぎます。

Claude Code での使用例：

document.md を PDF に変換して

document.md を academic テーマで PDF に変換して

Claude Code は、リクエストに基づいて適切なパラメータを使用して MCP ツールを自動的に使用します。

使用例

基本的な変換

my-document.md を PDF に変換して

オプション付き

report.md を以下のオプションで PDF に変換して：
- タイトル: 「2024年度年次報告書」
- 著者: 「山田太郎」
- テーマ: academic
- フォーマット: A4

カスタム CSS 使用

presentation.md を custom.css を使用してスタイリングして PDF に変換して

開発

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

# ビルド
npm run build

# ウォッチモード
npm run watch

動作の仕組み

この MCP サーバーは：

1. Claude Code からリクエストを受信
2. 入力パラメータの検証
3. 適切なオプションで md2pdf-ja CLI を実行
4. 変換結果を Claude Code に返す

トラブルシューティング

「md2pdf-ja: command not found」

md2pdf-ja がグローバルにインストールされていることを確認してください：

npm install -g @j2masamitu/md2pdf-ja
md2pdf-ja --version

Claude Code に MCP サーバーが表示されない

1. 設定ファイルのパスが正しいことを確認
2. JSON 構文が有効であることを確認
3. Claude Code を完全に再起動
4. Claude Code のログでエラーを確認

パーミッションエラー

dist/index.js ファイルが実行可能であることを確認してください：

chmod +x dist/index.js

ライセンス

MIT

関連プロジェクト

• md2pdf-ja - コアコンバータツール
• Model Context Protocol - MCP 仕様