PDFMonkey

PDFMonkey MCP サーバー

PDFMonkey の公式 Model Context Protocol（MCP）サーバーです。Claude、Cursor などの AI アシスタントやその他の MCP クライアントから、PDFMonkey API を通じてテンプレートの一覧表示、ドキュメントの生成、クォータの確認ができます。

• API キーを使って、stdio 経由でローカルに実行します
• MCP Registry に io.github.pdfmonkey/pdfmonkey-mcp として登録されています
• ドキュメント：pdfmonkey.io/docs/integrations/mcp

MCP サーバーは既存のテンプレートで動作します。テンプレートの読み取りはできますが、作成や編集はできません。エージェントにテンプレートの作成やプレビューを行わせるには、PDFMonkey CLI を使用してください。

API キーの取得

dashboard.pdfmonkey.io/register で登録し、アカウントページから API キーをコピーしてください。

セットアップ

このサーバーには Node.js 18 以降が必要です。キーは PDFMONKEY_API_KEY 環境変数から読み取ります。

Claude Code

claude mcp add pdfmonkey -e PDFMONKEY_API_KEY=your-api-key -- npx -y pdfmonkey-mcp-server

Claude Desktop、Cursor、その他のクライアント

以下をクライアントの MCP 設定に追加してください（Claude Desktop の場合は claude_desktop_config.json、Cursor の場合は .cursor/mcp.json）。

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "npx",
      "args": ["-y", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop の設定ファイルは、macOS では ~/Library/Application Support/Claude/ に、Windows では %APPDATA%\Claude\ にあります。

Docker

イメージはまだ公開されていないため、ローカルでビルドしてください。

docker build -t pdfmonkey-mcp-server .

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PDFMONKEY_API_KEY", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

Docker MCP Toolkit で使用する方法については、DOCKER-MCP-TOOLKIT.md を参照してください。

ツール

ツール	機能
list_workspaces	API キーでアクセスできるワークスペースを一覧表示します
list_templates	ワークスペースのテンプレートを一覧表示します
get_template	テンプレートの HTML、CSS、サンプルデータを取得します
generate_document	ドキュメントを生成して完了を待ちます（1.5 秒ごとに、最大 3 分間ポーリング）
get_document_status	ドキュメントのステータスを確認し、ダウンロード URL を取得します
list_documents	ステータス、テンプレート、更新日時で絞り込んでドキュメントを一覧表示します
delete_document	ドキュメントを完全に削除します
list_snippets	ワークスペースの Liquid スニペットを一覧表示します
get_snippet	スニペットのコードを取得します
get_quota	クォータとプランを取得します
get_user_info	アカウント情報を取得します

このサーバーは、list-templates-formatted、show-documents-status、generate-invoice、workspace-overview の 4 つのプロンプトも公開します。

知っておくと便利なこと：

• ダウンロード URL は 1 時間後に期限切れになります。すぐにファイルをダウンロードするか、共有リンクを使用してください（Pro+ および Premium プラン）。
• 生成に 3 分以上かかる場合は、後でドキュメント ID を指定して get_document_status を呼び出してください。

例

You: Generate an invoice for ACME with my invoice template.

Claude: [calls list_templates, then generate_document]
Your invoice is ready: https://…

開発

npm install
npm run build      # compile to dist/
npm test           # run the test suite
npm run watch      # rebuild on change

実際の API に対してサーバーを試すには：

PDFMONKEY_API_KEY=your-api-key npm start

トラブルシューティング

• 「PDFMONKEY_API_KEY environment variable is required」：クライアント設定にキーがありません。
• 401 エラー：キーが間違っているか、再生成されています。アカウントページから再度コピーしてください。
• Docker コンテナーがすぐに終了する：-i を付けて実行してください。MCP は stdin 経由で通信します。

リソース

• PDFMonkey ドキュメント
• MCP サーバーのドキュメント
• PDFMonkey CLI
• API リファレンス

サーバーに関する質問は、issue を作成してください。PDFMonkey 自体に関する質問は、お問い合わせください。

ライセンス

MIT。詳しくはLICENSEをご覧ください。