使用
Linux x86_64
需要先準備
- 執行環境:
python>=3.10
透過 uv tool 安裝
uv tool install mcp-documents-reader固定 mcp v1 以相容 FastMCP
uv pip install --python "$HOME"/.local/share/uv/tools/mcp-documents-reader/bin/python "mcp<2"
README 與實測不符之處
- README 寫: pip install mcp-documents-reader / uvx mcp-documents-reader works
實際可行: 啟動前在工具環境中固定 mcp<2(uv pip install --python ~/.local/share/uv/tools/mcp-documents-reader/bin/python 'mcp<2',得到 mcp 1.30.0)
在 pickfit 驗證過的原始指令(沙盒裡實際執行的)
僅供查核:裡面是沙盒的家目錄 /home/sbx。
uv tool install mcp-documents-reader 2>&1uv pip install --python /home/sbx/.local/share/uv/tools/mcp-documents-reader/bin/python "mcp<2" 2>&1加進你的 agent
claude mcp add mcp-documents-reader -- mcp-documents-readerClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"mcp-documents-reader": {
"command": "mcp-documents-reader",
"args": []
}
}
}在 AI 助理的設定中將 mcp-documents-reader 加入為 MCP 伺服器,再請助理依檔案路徑讀取文件。
它能做什麼
- 從 Excel 檔案取得工作表與儲存格資料已測試
怎麼使用
- 將
mcp-documents-reader連接到你的 MCP 用戶端。 - 請助理呼叫
read_document,並將filename設為 <path to .xlsx file>。 - 閱讀它回傳的工作表與儲存格文字。
- 將
- 從 DOCX 檔案取得文字與結構已測試
怎麼使用
- 將
mcp-documents-reader連接到你的 MCP 用戶端。 - 請助理呼叫
read_document,並將filename設為 <path to .docx file>。 - 閱讀它以文字形式回傳的標題與段落。
- 將
- 用單一工具讀取任何支援的文件已測試
怎麼使用
- 將
mcp-documents-reader連接到你的 MCP 用戶端。 - 呼叫
read_document,並將filename設為 <path to your file>,例如 PDF。 - 無論檔案類型為何,工具都會回傳文件的文字。
- 將
- 讀取 DOCX、PDF、Excel 與 TXT 文件沒有看到它可用
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 3 項可用
- 可離線使用
適合用來
- 讀取 DOCX 檔案
- 讀取 PDF 檔案
- 讀取 Excel 檔案
- 讀取文字檔
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年10月30日
- 版本 1.3.1
MCP 用戶端透過 stdio 連線,列出 1 個工具,呼叫 read_document 也回傳了結果。
測試機器遇到的差異
- README: README config uses uvx mcp-documents-reader
測試中: 改用已安裝的二進位檔 mcp-documents-reader 啟動,而非 uvx,讓重跑在離線狀態下也能運作