pdf-it

pdf-it

Markdown を、意図して作られたような見栄えの PDF に変換する Model Context Protocol（MCP）サーバー兼 Claude Code スキルです。表紙、目次、ページをまたいでも崩れないコードブロック、ページ番号付きのフッターを備えています。Claude セッションからコマンドを 1 つ実行するだけで、クライアントに送れるファイルが作成されます。

フォントはパッケージに同梱されているため、どのマシンでも PDF の見た目は変わりません。インストールも設定も不要です。

このツールを作った理由

Claude Code での調査セッションはいつも同じ結末です。有用な Markdown が大量にできあがる一方で、人が読みたいと思える PDF にきれいに変換する方法がありません。

Chrome の印刷機能では 30 秒かかり、出力は Word 文書のような見た目です。手作業での HTML 変換には文書ごとに 10 分かかります。Pandoc は使えますが、デフォルトの見た目は 2008 年の学術論文のようです。クライアントに送れる成果物を作れる方法はありません。

pdf-it ならコマンドは 1 つです。出力はデフォルトでデザインされています。

インストール

npm install -g pdf-it-mcp

または、npx pdf-it-mcp で必要なときに実行できます。

要件

• Node.js 20 以降
• ほかにインストールするものはありません。レンダラーとフォントはパッケージに同梱されています。

設定

Claude Desktop

claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "pdf-it": {
      "command": "npx",
      "args": ["-y", "pdf-it-mcp"]
    }
  }
}

Claude Code

claude mcp add pdf-it -- npx -y pdf-it-mcp

Cursor

Claude Desktop と同じ形式で ~/.cursor/mcp.json に追加します。

Cline / Continue / Zed / Goose

標準の MCP 設定を使用します。同じ npx -y pdf-it-mcp コマンドです。

使い方

サーバーに接続した任意の Claude セッションで、次のように依頼します。

これを PDF として保存して

次のような表現でも依頼できます。PDF としてエクスポート、これから PDF レポートを作成して、これを PDF に変換して、/pdf。スキルが依頼を検出し、pdf-it に処理を渡します。デフォルトでは、出力は ~/Documents/pdf-it/ に保存されます。

ツール

ツール	説明
generate_pdf	Markdown を PDF に変換します。テンプレート（research-report または plain）、表紙に表示する任意のタイトルと著者名、任意の出力パスを指定できます。
list_templates	利用可能なテンプレートの一覧と説明を返します。

generate_pdf のパラメーター

パラメーター	必須	説明
content	はい	変換する Markdown 文字列
title	いいえ	表紙とページフッターに表示されます
author	いいえ	日付の上に表紙に表示されます
output_path	いいえ	出力先の絶対パス。デフォルトは ~/Documents/pdf-it/{slug}-{timestamp}.pdf です
template	いいえ	research-report（デフォルト）または plain

テンプレート

名前	説明
research-report	タイトル、著者名、日付を記載した表紙。H1 および H2 見出しから目次を自動生成します。適切な階層構造の本文。タイトルとページ番号を記載したフッター。調査、要約、設計文書、レポートに最適です。
plain	表紙と目次はありません。本文のみのシンプルな形式です。短いメモや手早いエクスポートに最適です。

スキル

このパッケージには、SKILL.md の Claude Code スキルが含まれています。スキルが応答するトリガーフレーズは次のとおりです。

• これを PDF として保存して
• PDF としてエクスポート
• これから PDF レポートを作成して
• これを PDF に変換して
• PDF を生成して
• /pdf

スキルの仕様全体については、SKILL.md を参照してください。

出力

デフォルトでは、PDF は ~/Documents/pdf-it/{slug}-{timestamp}.pdf に書き込まれます。変更するには output_path を指定します。

デザイン

このパッケージには、次の3種類のフォントが含まれています。

• Newsreader は表紙タイトル（ディスプレイ 60、ライト）と本文の H1（ディスプレイ 32）に使用します。大きなサイズでも編集記事らしい重厚感を保つ、高コントラストのセリフ体です。
• DM Sans は H2、H3、表の文字、目次の見出しに使用します。控えめな下位階層を表現します。
• JetBrains Mono はページ番号、メタデータ、コード、図のキャプションに使用します。

純白の紙面、ほぼ黒の文字色（#111113）、日付と表のセルに使うセカンダリーの文字色（#2B2B2E）、ページ番号と日付に使う落ち着いたグレー（#7A7A7E）、極細の罫線（#E6E6E6）を使用します。アクセントカラーはありません。コードブロックは意図的にシンタックスハイライトなしで描画します。PDF では色の選択がすぐに古びてしまうためです。

すべての値は src/templates/design-tokens.ts にあり、唯一の信頼できる情報源になっています。別のデザイン言語を使いたい場合は、コンポーネントをフォークしてください。コンポーネントは src/templates/components/ にあり、機能を絞ったプレーンな React-PDF コンポーネントです。

仕組み

1. 解析： remark が Markdown を AST に変換します。
2. 構成： AST が型付き React コンポーネント（Cover、TOC、本文の基本要素である H1／H2／H3、Paragraph、CodeBlock、Blockquote、Table、リスト、チャート）に変換されます。
3. 描画： @react-pdf/renderer が React ツリーをラスタライズし、フォントを埋め込み、目次アンカーを含む決定的な PDF を生成します。
4. 出力： PDF は ~/Documents/pdf-it/{slug}-{timestamp}.pdf に保存され、タイトルと著者のメタデータが埋め込まれます。

所要時間：5ページのドキュメントで通常1秒未満、30ページで1～2秒です。

掲載先

npm、Glama、LobeHub に掲載されています。

免責事項

これは非公式のコミュニティ開発ツールです。Anthropic PBC との提携、同社による承認または後援はありません。Claude と Claude Code は Anthropic PBC の商標です。

pdf-it はローカルで動作し、独自のレンダラー（@react-pdf/renderer）とフォントを同梱しています。自己責任でご利用ください。誤用、プロンプトインジェクション、バグ、描画の失敗に起因する問題について、作者は一切責任を負いません。

ライセンス

MIT です。LICENSE を参照してください。