Gemini CLI + pdfmcp：セットアップガイド

settings.json経由でpdfmcpをGemini CLIに追加します。

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

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

場所： Wherever your client keeps its MCP server list

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

手順

Save the config at the location above — uvx fetches the pdfmcp package on first launch, so there is nothing to install by hand (or install it once with the pip command on the MCP page and use "command": "pdfmcp").
Restart Gemini CLI so it loads the new server.
Ask the agent to run a pdfmcp tool — it executes on this machine, and your files never leave it.

トラブルシューティング

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

試してみる

ローカル · MCPPDFをWord（DOCX）にPDFを編集可能なWordドキュメントに変換します。テキストベースの変換：段落と見出しはテキストレイヤーから再構築され、正確なレイアウト、表、画像は保持されません。デバイス上PDF情報とメタデータページ数、ページサイズ、メタデータ、暗号化状態をJSONで返します。デバイス上PDFを結合複数のPDFファイルをアップロード順に1つにまとめます。

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