conv2pdf

conv2pdf-mcp

conv2pdf API の公式 Model Context Protocol サーバーです。AI アシスタントは、Word、Excel、PowerPoint、Pages、画像、電子書籍、PostScript、HTML ファイルを PDF に変換できるほか、URL を指定してウェブページを PDF に変換できます。また、PDF を Word または画像に変換したり、コンピューター上の PDF を結合、分割、圧縮、保護、回転、ページ番号付けしたりできます。処理はフランスの OVHcloud サーバーで実行されます。EU 域外への転送はなく、処理経路に米国のサービスもありません。

インストール · ツール · 動作について · 開発

インストール

1. conv2pdf.com でアカウントを作成します。Dev プランには、12 か月間有効な無料変換が 300 回含まれています。有料プランについては料金をご覧ください。
2. ダッシュボードの Developer タブで、cpdf_live_ から始まる API キーを作成します。conv2pdf では、作成時に一度だけキーが表示されます。
3. CONV2PDF_API_KEY 環境変数にキーを設定して、MCP クライアントにサーバーを追加します。Node.js 22 以降が必要です。

Claude Code の場合：

claude mcp add --env CONV2PDF_API_KEY=cpdf_live_... --transport stdio conv2pdf -- npx -y conv2pdf-mcp

Windows では、npx の前に cmd /c を付けてください。

Claude Desktop、Cursor、その他の JSON ファイルで設定するクライアントの場合：

{
  "mcpServers": {
    "conv2pdf": {
      "command": "npx",
      "args": ["-y", "conv2pdf-mcp"],
      "env": { "CONV2PDF_API_KEY": "cpdf_live_..." }
    }
  }
}

または、Claude Code ではプラグインをインストールします。同じサーバーに、どのツールをどの順番で呼び出すか、また各呼び出しの料金をアシスタントに伝えるスキルが付属しています。

/plugin marketplace add jamalofski/conv2pdf-mcp
/plugin install conv2pdf@conv2pdf

プラグインを有効にすると、Claude Code が API キーを尋ねます。キーは設定ファイルではなく、システムの認証情報ストアに保存されます。後から設定するには、/plugin configure conv2pdf@conv2pdf を実行するか、/plugin を開いて、Installed タブから conv2pdf を選び、Configure options を選択します。npx -y conv2pdf-mcp コマンドで手動追加したサーバーは、プラグインのサーバーより優先されます。

SKILL.md スキルを読み込む別のエージェントを使う場合は、上記のとおりサーバーを追加し、スキルだけを使用してください。このリポジトリの plugin/skills/conv2pdf/SKILL.md は、Agensi にも掲載されています。

あとは、必要なことを依頼してください。「report.docx を PDF に変換して」「この 3 つの PDF を結合して」「scan.pdf を圧縮してパスワードで保護して」などと頼めます。

ツール

ツール	機能
convert_to_pdf	拡張子に基づいて、Word、Excel、PowerPoint、OpenDocument、Apple Pages、RTF、TXT、CSV、PNG、JPG、WebP、GIF、TIFF、HEIC、EPUB、PostScript（PS、EPS）、HTML ファイルを PDF に変換
convert_url_to_pdf	URL を指定して公開ウェブページを PDF に変換。ブラウザーで印刷した場合と同様に出力
convert_heic_to_jpg	iPhone の HEIC または HEIF 写真を JPG に変換
convert_pdf_to_word	実テキストを含む PDF を編集可能な DOCX ドキュメントに変換
convert_pdf_to_images	1 ページにつき 1 枚の PNG または JPG を ZIP ファイルに出力
merge_pdfs	複数の PDF を指定した順に 1 つに結合
extract_pdf_pages	1-5,7,10-12 のように指定したページを、記述した順に新しい PDF へコピー
split_pdf	1 ページにつき 1 つの PDF を ZIP ファイルに出力
rotate_pdf	すべてのページを 90、180、または 270 度回転
add_page_numbers	ページ下部の中央、左、または右に、「3 / 12」や「3」の形式でページ番号を追加
add_watermark	最大 50 文字のテキストをすべてのページにスタンプ
compress_pdf	画像を 72、150、または 300 DPI にしてサイズを縮小
protect_pdf	パスワードを設定し、必要に応じて印刷やコピーを禁止
unlock_pdf	知っているパスワード、または印刷やコピーの制限を解除
get_quota	API キーのプラン、使用状況、上限

動作

• 変換を除き、ファイルはコンピューター内にとどまります。 ツールはファイルのパスを受け取り、そのファイルを conv2pdf に送信して、結果をディスクに書き込みます。conv2pdf はファイル名だけでなく、ファイルの内容を確認します。
• 上書きはされません。 結果は入力ファイルの隣に保存されます。report.docx の場合は report.pdf になり、PDF ツールの場合は report-compressed.pdf のように接尾辞が追加されます。同じ名前のファイルがすでにある場合、サーバーは report (2).pdf を書き込みます。アシスタントは output_path で保存先を指定できます。その場所にファイルがすでにある場合、ツールは変換を始める前に拒否します。Web ページには隣に書き込む入力ファイルがないため、convert_url_to_pdf では必ず output_path を指定します。
• サーバーから削除されます。 結果がディスクに保存されると、サーバーは conv2pdf のジョブを削除します。削除に失敗した場合、conv2pdf は1時間後にファイルを削除します。
• クォータ。 変換ごとにプランのクォータを1回分消費します。ファイルの読み取り後に conv2pdf が拒否した場合も対象です。たとえば、読み取り不能な PDF、スキャンされた PDF、ページ数が多すぎる PDF などが該当します。受信時に拒否されたファイル（形式が違う、サイズが大きすぎる、パスワードがない）、拒否された設定（存在しないページ範囲、短すぎるパスワード）、conv2pdf 側での失敗はクォータを消費せず、get_quota も無料です。ファイルサイズの上限は、Dev プランでは 10 MB、有料プランでは 200 MB です。
• レート制限。 API では、API キーごとに1分あたり20回まで変換できます。API から速度を落とすよう指示された場合や、キューが満杯の場合、サーバーは API が指定する時間だけ待ってから再試行します。再試行は最大2回で、待ち時間が30秒以内の場合に限られます。それ以外の場合、アシスタントに待ち時間が通知されます。
• 保護された PDF。 merge_pdfs を除く、PDF を読み取るツールは、アシスタントが password でパスワードを渡すと、パスワードを要求する PDF を開きます。結果にパスワードは設定されません。PDF を結合する場合は、先に保護された PDF のロックを解除してください。
• Pages と Numbers。 Pages 書類の拡張子は .pages のままです。Numbers のスプレッドシートとの違いは名前だけですが、conv2pdf は Numbers のスプレッドシートを Keynote プレゼンテーションと同様に変換しません。
• エラー。 拒否された場合、アシスタントには対応可能な説明文が返されます。たとえば、パスワードの誤り、存在しないページ範囲、プランの上限、設定すべきキーなどです。呼び出しがキャンセルされると転送が停止し、ファイルは残りません。
• キーなしの場合。 サーバーは起動してツールを一覧表示します。呼び出し時に CONV2PDF_API_KEY の設定方法が説明されます。

各リクエストには User-Agent: conv2pdf-mcp/<version> が含まれます。サポートに問い合わせるときは、これを伝えてください。API のログで、あなたの呼び出しを識別できます。

開発

このサーバーには依存関係がありません。Node.js がソースをそのまま実行します。stdio でクライアントと通信し、同じプロセスからプロトコルの新旧両方の仕様に対応します。各リクエストにプロトコルバージョンが含まれるリビジョン 2026-07-28 と、initialize ハンドシェイクで始まる以前のリビジョン（2025-11-25 から 2024-11-05 まで）です。

npm test

ローカルポート上の conv2pdf API の偽物を使ってテストを実行します。キーもネットワーク接続も必要ありません。

npm run check-tools

convert_to_pdf で拡張子のルートが有効になっているかどうかを、実際の API が受け付けるもの（GET /v1/tools）と照合します。

プラグイン

plugin/ には Claude Code プラグインが含まれています。マニフェスト、公開済みパッケージを npx で起動する .mcp.json、およびスキル plugin/skills/conv2pdf/SKILL.md です。.claude-plugin/marketplace.json は、Claude Code がこのリポジトリからプラグインをインストールできるようにするカタログです。どちらも npm パッケージには含まれません。npm test は、プラグインのバージョンがパッケージと一致していること、およびスキルにサーバーのツールが記載されていることを確認します。

claude plugin validate . --strict
claude --plugin-dir ./plugin

マニフェストを確認してから、インストールせずにフォルダーからプラグインを読み込んでセッションを開始します。ユーザーがプラグインまたはスキルの変更を受け取るのは、バージョンが変わったときです。変更はリリースに含まれます。

リリース

1. package.json、server.json、plugin/.claude-plugin/plugin.json のバージョンを設定し、CHANGELOG.md の該当セクションに日付を記入します。
2. npm test と npm run check-tools を実行します。
3. コミットし、バージョン名のタグをプッシュします。Publish ワークフローによって、プロビナンスステートメントを付与したうえで Trusted Publishing を通じて npm にパッケージが公開されます。
4. MCP Registry のエントリーを公開します。mcp-publisher login http --domain conv2pdf.com を実行し、続けて mcp-publisher publish を実行します。com.conv2pdf/conv2pdf という名前は、https://conv2pdf.com/.well-known/mcp-registry-auth で公開されている公開鍵によって証明されます。
5. スキルに変更があった場合は、新しいバージョンとしてAgensi の掲載ページに再度アップロードします。SKILL.md を含む conv2pdf/ フォルダーの ZIP をアップロードしてください。このリポジトリから掲載内容が更新されることはありません。

リソース

• conv2pdf API ドキュメント
• Agensi の conv2pdf スキル
• Model Context Protocol 仕様

サポート

イシューを作成するか、[email protected] までご連絡ください。

ライセンス

MIT です。詳細は LICENSE をご覧ください。