docalyze

Docalyze MCP 服务

一个 MCP（Model Context Protocol）服务，可让 AI 助手读取并以可视化方式分析本地文档，包括 PDF、Excel 电子表格、CSV 文件、Word 文档、PowerPoint 演示文稿和图像。

无需 API 密钥。宿主 AI（GitHub Copilot、Claude 等）会直接完成所有推理。

支持的格式

格式	扩展名	读取	可视化
PDF	.pdf	✅	✅
Excel	.xlsx、.xls	✅	✅
CSV / TSV	.csv、.tsv	✅	—
JSON	.json	✅	—
Word	.docx	✅	✅
PowerPoint	.pptx	✅	✅
纯文本	.txt、.md	✅	—
图像	.png、.jpg、.jpeg、.gif、.bmp、.tiff、.webp	—	✅

工具

工具	描述
list_documents	列出目录下的文件，并按 glob 模式筛选
document_info	获取文件元数据（大小、修改日期、工作表）
read_document	分页提取文档中的文本内容
visual_evaluate_document	内嵌返回页面图像，以便 AI 分析图表、表格和示意图

安装

通过 VS Code 安装（推荐）

在 MCP 服务库中搜索 docalyze（扩展侧边栏 → MCP 选项卡），然后点击“安装”。

通过 PyPI 安装

pip install docalyze-mcp-server

通过 npm 安装

npx docalyze-mcp-server

这需要已安装 uv 或 pipx — npm 封装程序会调用 uvx 自动运行 Python 包。

手动设置

将以下内容添加到 VS Code 的 mcp.json（或 settings.json）中：

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

或者，如果你通过 pip 安装并想使用入口点：

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

可选依赖项

基础安装支持 PDF、Excel、CSV、JSON 和纯文本。要支持其他格式：

# 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]

配置

服务会从可配置的根目录读取文档。设置 DOCUMENTS_ROOT 环境变量即可更改此目录：

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

如果未设置，默认使用包含服务脚本的目录。

许可证

MIT