Docalyze

io.github.LunarPerovskite由 GitHub 帳號 LunarPerovskite 發布v0.2.1更新於 Oct 24, 2026

Read and analyze local documents (PDF, Excel, CSV, Word, PowerPoint, images). No API keys needed.

已驗證STDIO僅桌面檔案與儲存資料與分析

概覽

AI 產生的概覽

本機 MCP 伺服器，讓 AI 助理列出、讀取並以視覺方式分析本機文件，支援 PDF、Excel、CSV、Word、PowerPoint 與圖片。

可以做什麼
  • 依 glob 模式列出目錄下的檔案
  • 查看檔案中繼資料，例如大小、修改日期與工作表名稱
  • 分頁擷取文件中的文字內容
  • 以內嵌圖片方式回傳頁面，讓助理分析圖表、表格與示意圖
  • 支援 PDF、Excel、CSV/TSV、JSON、Word、PowerPoint、純文字與常見圖片格式
適用情境
適合讓助理處理本機的報告、試算表、簡報或掃描頁面，不必上傳到文件服務，也不需要任何 API 金鑰。
執行需求
以本機 stdio 程序執行；可從 PyPI 以 pip 安裝，或以 npx 執行（需已安裝 uv 或 pipx）。Word、PowerPoint 與 OCR 為選用附加元件，OCR 另需系統安裝 Tesseract。環境變數 DOCUMENTS_ROOT 指定讀取目錄，未設定時預設為伺服器腳本所在目錄。
安裝前請注意
它會讀取所設定根目錄下的檔案，請將 DOCUMENTS_ROOT 指向你願意讓助理存取的資料夾。頁面圖片與擷取的文字會傳給宿主 AI 模型，文件內容會隨對話離開你的電腦。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Docalyze，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[Docalyze Logo]

Docalyze MCP Server

An MCP (Model Context Protocol) server that lets AI assistants read and visually analyze local documents — PDFs, Excel spreadsheets, CSV files, Word documents, PowerPoint presentations, and images.

No API keys required. The host AI (GitHub Copilot, Claude, etc.) does all the reasoning directly.

Supported Formats

FormatExtensionsReadVisual
PDF.pdf✅✅
Excel.xlsx, .xls✅✅
CSV / TSV.csv, .tsv✅—
JSON.json✅—
Word.docx✅✅
PowerPoint.pptx✅✅
Plain text.txt, .md✅—
Images.png, .jpg, .jpeg, .gif, .bmp, .tiff, .webp—✅

Tools

ToolDescription
list_documentsList files under a directory, filtered by glob pattern
document_infoGet metadata (size, modified date, sheets) for a file
read_documentExtract text content from a document with pagination
visual_evaluate_documentReturn page images inline so the AI can analyze charts, tables, and diagrams

Installation

From VS Code (recommended)

Search for docalyze in the MCP server gallery (Extensions sidebar → MCP tab) and click Install.

From PyPI

bash
pip install docalyze-mcp-server

From npm

bash
npx docalyze-mcp-server

This requires uv or pipx installed — the npm wrapper calls uvx to run the Python package automatically.

Manual setup

Add to your VS Code mcp.json (or settings.json):

jsonc
{  "servers": {    "docalyze": {      "type": "stdio",      "command": "python",      "args": ["-m", "docalyze_mcp_server"],      "env": {        "PYTHONIOENCODING": "utf-8"      }    }  }}

Or, if you installed via pip and want to use the entry point:

jsonc
{  "servers": {    "docalyze": {      "type": "stdio",      "command": "docalyze-mcp-server"    }  }}

Optional Dependencies

The base install handles PDF, Excel, CSV, JSON, and plain text. For additional formats:

bash
# Word documentspip install docalyze-mcp-server[docx]
# PowerPointpip install docalyze-mcp-server[pptx]
# OCR (requires Tesseract installed on your system)pip install docalyze-mcp-server[ocr]
# Everythingpip install docalyze-mcp-server[all]

Configuration

The server reads documents from a configurable root directory. Set the DOCUMENTS_ROOT environment variable to change it:

jsonc
{  "servers": {    "docalyze": {      "type": "stdio",      "command": "docalyze-mcp-server",      "env": {        "DOCUMENTS_ROOT": "/path/to/your/documents"      }    }  }}

If not set, it defaults to the directory containing the server script.

License

MIT

來源：README.md，提交 ec8e470

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分