AI导哈

文档处理服务器

一个基于Model Context Protocol（MCP）的服务器，用于读取、转换和保存文档，支持多种文件格式，包括PDF、Word、Excel等，并集成OCR功能。

  • by Vishvin95
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Vishvin95/DocumentBrainMCP

使用说明

DocumentBrain

用于读取、转换和保存文档的MCP（模型上下文协议）服务器。内置于 FastMCP 和 MarkItDown，它使LLM能够与本地计算机上的文件进行交互。

特性

工具

工具 说明
阅读任何文档 读取任何支持的文档并返回其文本内容，包括图像的OCR。
将文件保存到PC 将内容保存到计算机上指定路径的文件中。

资源

资源 URI 描述
本地文档目录 docs://files 列出当前工作目录中的所有文件。
文件内容 docs://file/{filename} 检索特定文件的转换文本内容。

提示

提示 描述
analyze_data 根据用户提供的文本生成一首有创意的四行歌曲。

安装

先决条件

  • Python>=3.12

从源代码安装

pip install -e .

从PyPI安装

pip install vvin-document-brain

用法

运行MCP服务器

mcp-document-brain

在游标中配置

将以下内容添加到Cursor MCP配置文件中 ~/.cursor/mcp.json:

使用 uvx （推荐--无需安装）：

{
  "mcpServers": {
    "DocumentBrain": {
      "command": "uvx",
      "args": ["vvin-document-brain"]
    }
  }
}

缓存路径问题？ 如果 uvx 失败，出现“权限被拒绝”错误 ~/.cache/uv 或 ~/.local/share/uv （在受管/公司计算机上很常见），添加 env block重定向两条路径：

{
  "mcpServers": {
    "DocumentBrain": {
      "command": "uvx",
      "args": ["vvin-document-brain"],
      "env": {
        "UV_CACHE_DIR": "/tmp/cache/uv",
        "XDG_DATA_HOME": "/tmp/uv-data"
      }
    }
  }
}

使用pip install（如果已全局安装）：

{
  "mcpServers": {
    "DocumentBrain": {
      "command": "vvin-document-brain"
    }
  }
}

在Claude桌面中配置

添加以下内容 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "DocumentBrain": {
      "command": "uvx",
      "args": ["vvin-document-brain"]
    }
  }
}

工具使用示例

阅读文档：

Tool: read_any_document
Arguments: { "file_path": "~/Documents/report.pdf" }

保存文件：

Tool: save_file_to_pc
Arguments: { "filepath": "/path/to/output.txt", "content": "Hello, world!" }

项目结构

DocumentBrain/
├── src/
│   └── document_brain/
│       ├── __init__.py
│       └── server.py        # MCP server with tools, resources, and prompts
├── tests/
│   └── test_server.py
├── pyproject.toml
└── README.md

支持的文件格式

DocumentBrain利用MarkItDown转换各种文件格式，包括：

  • PDF
  • Word文档（.docx）
  • Excel电子表格（.xlsx）
  • PowerPoint演示文稿（.pptx）
  • 图像（带OCR）
  • 超文本标记语言
  • 纯文本
  • 更多（参见 Markitdown文档 完整列表）

发展

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

许可证

麻省理工学院

作者

维什韦什·文丘卡vishwesh.vinchurkar@gmail.com

相关 MCP