第三方工具更新 2026.11.21

PDF Reader MCP 教學:Windows 安裝、AnyMD 改名與指定頁碼讀取

Windows設定PDF Reader MCP與AnyMD,接上Claude Code、Codex。實測指定頁碼、全文與字面搜尋,修正read_pdf舊教學及文字稀少的OCR提示。

PDF Reader MCP 現在叫 AnyMD:它在本機把文件轉成 AI 可讀的 Markdown,保留 PDF 頁碼,適合從報告找一段文字再回到原頁確認。舊套件名稱仍能安裝,但工具已換成 read、search 等名稱。只要看幾行文字,直接貼給 AI 比安裝簡單;需要反覆讀多頁 PDF,才值得接這個伺服器。

Windows 安裝與客戶端設定

需要 Node.js 18 以上。以下在新的 PowerShell 資料夾安裝相容套件 8.5.11,這個版本會啟動同版 AnyMD。

npm.cmd install --save-exact --no-audit --no-fund @sylphx/pdf-reader-mcp@8.5.11
New-Item -ItemType Directory -Force documents | Out-Null
$node = (Get-Command node.exe).Source
$entry = (Resolve-Path .\node_modules\@sylphx\pdf-reader-mcp\bin\pdf-reader-mcp.js).Path
$docs = (Resolve-Path .\documents).Path
$cache = Join-Path (Get-Location) 'anymd-cache'

Claude Code:

claude.cmd mcp add pdf --scope project --env "ANYMD_CACHE_DIR=$cache" -- $node $entry "--allow-dir=$docs"
claude.cmd mcp list

Codex:

codex mcp add pdf --env "ANYMD_CACHE_DIR=$cache" -- $node $entry "--allow-dir=$docs"
codex mcp list

Claude 的健康檢查應顯示 Connected;重新開啟 AI 工作階段後再下文件任務。--allow-dir 只開放 documents,快取另放在目前專案。沒有執行會一次更改多個客戶端的 setup 命令。

Cursor 可依上游 Cursor 設定,在 .cursor/mcp.json 使用 mcpServers,指定相同 Node 執行檔、入口及 --allow-dir。原生 Windows 執行檔由 npm 的平台相依套件提供,不需要另外編譯 Rust。

準備一份看得出頁碼的範例

你可以使用自己的文字 PDF。想重現下面結果,可用 uv 建立兩頁範例:

uv venv --python 3.12 .venv
uv pip install --python .\.venv\Scripts\python.exe reportlab==5.1.0

將這段存成 make_pdf.py,再執行 .\.venv\Scripts\python.exe make_pdf.py:

from reportlab.pdfgen import canvas
c = canvas.Canvas('documents/sales.pdf')
c.drawString(72, 740, 'Taipei sales: 200 TWD')
c.showPage()
c.drawString(72, 740, 'Kaohsiung sales: 50 TWD')
c.save()

三個可以直接貼上的用途

1. 只讀需要的頁

只用 PDF MCP 的 read,讀 documents/sales.pdf,pages="2"、ocr=false、
images="none"。使用完整檔案路徑,保留工具回傳的頁碼,不要讀整個資料夾。

結果應含 <!-- page 2 --> 與 Kaohsiung sales: 50 TWD,不應把第一頁的 200 當成這一頁的金額。先選頁再提問,能減少無關內容進入對話。

2. 跨頁核對資料

用 read 讀同一個 sales.pdf,pages="1-2"、ocr=false、images="none"。
按原始頁碼列出城市與金額;缺資料就指出,不要自行補值。

本例第 1 頁是 Taipei/200,第 2 頁是 Kaohsiung/50。Markdown 內的頁碼標記是回查原檔的線索,不等於已驗證每個版面元素都被完整擷取。

3. 搜尋後帶著頁碼回答

用 search 搜尋 Taipei,mode="literal",sources只放這份sales.pdf的完整路徑。
列出命中頁碼與原文,再回答Taipei的銷售金額。

我們取得 1 筆命中,指向 p.1,原文包含 Taipei sales: 200 TWD。指定 literal 可明確要求字面搜尋,避免把相近主題的段落當成同一個詞的命中。

常見問題與排錯

  • 找不到 read_pdf: 舊教學的單一 PDF 工具已不是 8.5.11 的介面。請讓 AI 讀取目前工具結構;本版提供 outline、read、search、inspect,本例只需要中間兩個。
  • 已經有文字卻出現掃描頁提示: 我們的每頁只有一行,仍收到 These pages have little or no selectable text。先看正文是否已經正確擷取,不要只因提示就下載 OCR 模型。文字稀少與完全沒有文字是不同情況。
  • 找不到原生執行檔: 檢查 npm 安裝是否略過 optional dependencies;Windows x64 需要對應的 @sylphx/anymd-win32-x64-msvc。在正確平台重新安裝,不要拿 Linux 執行檔改副檔名。
  • 路徑被拒絕或找不到檔案: 把 PDF 放在允許目錄,先確認完整路徑。檔名相對於 AI 的工作目錄與伺服器允許目錄不一定相同,所以範例提示詞明確要求完整路徑。

費用、範圍與替代方案

本機核心採 MIT 授權,文字 PDF 的讀取與搜尋不需要帳戶或 API key。另有付費 Pro 功能與按頁計費的託管服務;這裡用的是本機免費核心。AI 客戶端自己的用量另外計算。

掃描件需要 OCR 路線及相應軟體/模型。複雜表格、雙欄、圖片與頁面完整性要以自己的文件檢查;這個兩行範例只用來核對頁碼和文字。要建立可程式化的頁面擷取流程,可以看 PyMuPDF4LLM;需要處理多種辦公室文件,也可比較 MarkItDown 的轉檔方式。

FAQ

PDF Reader MCP 改名後,要重新建立帳戶嗎?

本機使用不需要帳戶。8.5.11 的舊 npm 名稱是 AnyMD 的相容入口,會啟動相同版本的程式。新的安裝可以直接採上游 AnyMD 名稱;現有設定最重要的是更新工具名稱與核對實際版本。

可以只讓 Claude Code 讀某幾頁嗎?

可以,read 的 pages 參數接受例如 2、1-5,8。在提示詞保留原頁碼,並要求答案附上頁碼與原文片段。本例在 Codex 以相同 MCP 介面驗證了單頁與雙頁讀取。

搜尋命中代表整份 PDF 都讀完整了嗎?

不是。字面搜尋只能證明回傳的位置有該字詞;掃描文字、未處理頁面或特殊版面可能需要其他檢查。若你要確認完整性,應先核對總頁數、讀取範圍與原檔,再對關鍵內容抽查。

我們測了什麼

2026-11-16:Windows、Node 24、相容套件與 AnyMD 8.5.11、ReportLab 5.1.0。Codex 真讀兩頁文字 PDF、指定第 2 頁、跨頁讀取與字面搜尋;Claude Code 註冊健康檢查 Connected。沒有測 OCR、付費功能、複雜表格或 Cursor。參考官方 README與改名說明,查閱日期同上。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

看過去幾期

也可以在這些平台追蹤: