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 檔案合併為一個。