About io.github.LunarPerovskite/docalyze
io.github.LunarPerovskite/docalyze is an MCP server in the Files category: read and analyze local documents (PDF, Excel, CSV, Word, PowerPoint, images). No API keys needed.
Install
uvx docalyze-mcp-serverpip install docalyze-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
document_infoGet metadata (size, modified date, sheets) for a file
Parameters not published.
list_documentsList files under a directory, filtered by glob pattern
Parameters not published.
read_documentExtract text content from a document with pagination
Parameters not published.
visual_evaluate_documentReturn page images inline so the AI can analyze charts, tables, and diagrams
Parameters not published.
Ask AI
Ask AI about io.github.LunarPerovskite/docalyze
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.