Claude Code + pdfmcp：セットアップガイド

1つのコマンド、または.mcp.json経由でpdfmcpをClaude Codeに追加します。

ローカルのみ。同じ74ツールがあなたのマシンで動作します。アカウントなし、キーなし、制限なし。 Claude Codeでは、このページの設定でpdfmcpがあなたのマシンで動作します。設定を入れ替えれば、いつでも再インストールやクライアント変更ができます。

必要なもの： ローカルpdfmcpパッケージ：一度インストールしてください（または初回起動時にuvxにダウンロードさせてください）。アカウントも、キーも、置き換える秘密もありません。

場所： Wherever your client keeps its MCP server list

claude mcp add pdfmcp -- uvx --from https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl pdfmcp

手順

Run the command above (or add the JSON below to .mcp.json in your project root).
Restart Claude Code and run /mcp to confirm pdfmcp is connected.
Try: “Use pdfmcp to merge these two PDFs” — it runs on this machine.

Project-scoped .mcp.json alternative (same local server, no key):

設定

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

トラブルシューティング

ローカルサーバーが起動しない：パッケージを一度 pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl でインストールし、ターミナルで pdfmcp を実行してエラーを確認してください — 通常はパッケージのダウンロードがブロックされているか、Python が 3.11 未満です。
ツールが表示されません：設定を編集した後はクライアントを完全に再起動してください。ほとんどのクライアントは起動時にのみMCPサーバーを読み込みます。
エンジンが起動しません：重いエンジンは初回利用時に一度だけダウンロードされます。そのダウンロードのための接続を確認して再試行してください。その後はすべてローカルで動作します。

試してみる

デバイス上PDFを圧縮Ghostscriptでファイルサイズを削減します。プリセット：light（印刷品質）、medium（電子書籍）、heavy（画面用、最小）。ローカル · MCPOCR — 検索可能なPDFスキャンしたPDFを検索可能にします。テキストレイヤーのないページはTesseractでOCRされ、見えないテキストレイヤーを得ます。すでにテキストがあるページはそのまま通過し、スキップとして報告されます。ローカル · MCPPDFをWord（DOCX）にPDFを編集可能なWordドキュメントに変換します。テキストベースの変換：段落と見出しはテキストレイヤーから再構築され、正確なレイアウト、表、画像は保持されません。

その他のクライアント： Claude Desktop MCPセットアップ · ChatGPT MCPセットアップ · Cursor MCPセットアップ · すべてのMCPセットアップガイド · ローカルAPIガイド