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

Claude DesktopにpdfmcpをローカルMCPサーバーとして追加します。

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

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

場所： claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config)

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

手順

Merge the config below into claude_desktop_config.json (create the file if it doesn't exist).
Fully restart Claude Desktop.
Drop in a PDF and ask Claude to extract the text — it happens on this machine.

Local servers live in the config file — the Settings → Connectors UI is for remote servers and can't start local processes.

uvx downloads the pdfmcp package on first launch and keeps it cached. No key is involved: the tools run on this machine.

トラブルシューティング

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

試してみる

デバイス上PDFをテキストにプレーンテキストを抽出します。ページごとにフォームフィードで区切られたセクションになります。デバイス上PDFを圧縮Ghostscriptでファイルサイズを削減します。プリセット：light（印刷品質）、medium（電子書籍）、heavy（画面用、最小）。ローカル · MCPOCR — 検索可能なPDFスキャンしたPDFを検索可能にします。テキストレイヤーのないページはTesseractでOCRされ、見えないテキストレイヤーを得ます。すでにテキストがあるページはそのまま通過し、スキップとして報告されます。

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