Docalyze

io.github.LunarPerovskitePublished by GitHub account LunarPerovskitev0.2.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFiles & StorageData & Analytics

Overview

AI-generated overview

Local MCP server that lets an AI assistant list, read and visually analyze documents on your machine — PDF, Excel, CSV, Word, PowerPoint and images.

What you can do
  • List files in a directory, filtered by glob pattern
  • Inspect file metadata such as size, modified date and sheet names
  • Extract text from documents with pagination
  • Return page images inline so the assistant can analyze charts, tables and diagrams
  • Read PDF, Excel, CSV/TSV, JSON, Word, PowerPoint, plain text and common image formats
When to use it
Useful when you want an assistant to work through local reports, spreadsheets, slide decks or scanned pages without uploading them to a document service, and without any API keys.
Requirements
Runs as a local stdio process; install from PyPI (pip) or run via npx, which needs uv or pipx installed. Optional extras add Word, PowerPoint and OCR support; OCR also needs Tesseract on the system. The DOCUMENTS_ROOT environment variable sets the directory it reads from, defaulting to the server script's directory.
Before you install
It reads files from the configured root directory, so point DOCUMENTS_ROOT at a folder you are comfortable exposing to the assistant. Page images and extracted text are passed to the host AI model, so document contents leave your machine as part of the conversation.

Installation

In SourceWeft

  1. Open Docalyze in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit ec8e470

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts