English Français العربية

io.github.LunarPerovskite/docalyze

Official registry Data and databases

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package docalyze-mcp-server
Claude Code 
claude mcp add docalyze -- uvx docalyze-mcp-server==0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "docalyze": {
            "command": "uvx",
            "args": [
                "docalyze-mcp-server==0.2.1"
            ]
        }
    }
}
NPM package docalyze-mcp-server
Claude Code 
claude mcp add docalyze -- npx -y docalyze-mcp-server@0.2.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "docalyze": {
            "command": "npx",
            "args": [
                "-y",
                "docalyze-mcp-server@0.2.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Docalyze MCP Server
  2. Supported Formats
  3. Tools
  4. Installation
  5. Optional Dependencies
  6. Configuration
  7. License

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

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

Frequently asked questions

What is io.github.LunarPerovskite/docalyze?

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

How do I install io.github.LunarPerovskite/docalyze?

It runs on your machine. In Claude Code: claude mcp add docalyze -- uvx docalyze-mcp-server==0.2.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.LunarPerovskite/docalyze need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.LunarPerovskite/docalyze open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.LunarPerovskite/docalyze?

It is published by LunarPerovskite. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.