About docalyze
docalyze is an MCP server that lets AI assistants read and visually inspect local documents, including PDFs, spreadsheets, office files, and images. The host AI performs the reasoning, so no API keys are required.
Key features
- 01List files under a directory
- 02Read document text with pagination
- 03Return page images for visual analysis
- 04Support office files, data files, and images
Use cases
- 01Extract text from a local PDF or spreadsheet
- 02Inspect charts and tables in document pages
- 03Review local Word or PowerPoint files
MCP support
docalyze exposes document listing, metadata, text-reading, and visual-evaluation tools to MCP clients. It reads files from a configurable local root directory.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README
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
| Format | Extensions | Read | Visual |
|---|---|---|---|
.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
| Tool | Description |
|---|---|
list_documents | List files under a directory, filtered by glob pattern |
document_info | Get metadata (size, modified date, sheets) for a file |
read_document | Extract text content from a document with pagination |
visual_evaluate_document | Return 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
pip install docalyze-mcp-server
From npm
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):
{
"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:
{
"servers": {
"docalyze": {
"type": "stdio",
"command": "docalyze-mcp-server"
}
}
}
Optional Dependencies
The base install handles PDF, Excel, CSV, JSON, and plain text. For additional formats:
# Word documents
pip install docalyze-mcp-server[docx]
# PowerPoint
pip install docalyze-mcp-server[pptx]
# OCR (requires Tesseract installed on your system)
pip install docalyze-mcp-server[ocr]
# Everything
pip install docalyze-mcp-server[all]
Configuration
The server reads documents from a configurable root directory. Set the DOCUMENTS_ROOT environment variable to change it:
{
"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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.