@j2masamitu/md2pdf-ja-mcp

v1.0.1

Published

5 months ago

MCP server for md2pdf-ja - Convert Japanese Markdown to PDF

0High
0Medium
0Low

j2masamitu

mcp markdown pdf japanese converter claude mcp-server

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 サーバーは：

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

トラブルシューティング

「md2pdf-ja: command not found」

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

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

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

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

パーミッションエラー

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

chmod +x dist/index.js

ライセンス

MIT