mcp-document-reader

mcp-document-reader

site icon
2025.03.09 3
Python文档处理其它
mcp-document-reader 是一个基础的 MCP 服务器,用于与 PDF 和 EPUB 文档进行交互。它主要用于与 Windsurf IDE by Codeium 配合使用,因为 Windsurf IDE 仅支持 MCP 工具而不支持资源。
View on GitHub

Overview

基本能力

产品定位

mcp-document-reader 是一个用于处理 PDF 和 EPUB 文档的 MCP 服务器,旨在为开发者提供文档交互能力。

核心功能

  • 支持与 PDF 和 EPUB 文档的交互。
  • 提供基本的文档读取能力。
  • 可以与 Windsurf IDE by Codeium 集成使用。

适用场景

  • 开发者需要在 Windsurf IDE 中处理 PDF 或 EPUB 文档时。
  • 需要快速搭建一个轻量级的文档交互服务时。

工具列表

  • mcp-document-reader:主服务工具,用于启动文档交互服务。

常见问题解答

无明确常见问题解答部分。

使用教程

使用依赖

  • Python 3.11+
  • Poetry

安装依赖命令:

# 安装 Python 3.11+
# 安装 Poetry

安装教程

  1. 克隆仓库并安装依赖:
git clone https://github.com/jbchouinard/mcp-document-reader.git
cd mcp-document-reader
poetry install
  1. 配置 MCP 服务器:
{
  "mcpServers": {
    "documents": {
      "command": "poetry",
      "args": ["-C", "path/to/mcp-document-reader", "run", "mcp-document-reader"]
    }
  }
}

或者使用 pipx 安装:

poetry build
pipx install dist/*.whl
which mcp-document-reader

然后使用以下配置:

{
  "mcpServers": {
    "documents": {
      "command": "/path/to/mcp-document-reader",
      "args": []
    }
  }
}

调试方式

  1. 运行测试:
poetry run pytest
  1. 代码检查和格式化:
poetry run ruff check --fix .
poetry run ruff format .

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。