PDF文档处理服务

一个基于MCP协议的PDF文档阅读与处理服务,提供文档文本提取和转换功能,适用于文档管理和内容分析场景。

  • by mlexpertio
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 mlexpertio/mcp-pdf-reader

使用说明

MCP PDF阅读器

一种模型上下文协议(MCP)服务器,提供读取和处理PDF文档的工具。使用Docling构建,用于文档转换和文本提取。

特性

  • MCP服务器 使用PDF文档处理工具
  • 文档文本提取:将PDF内容转换为干净的Markdown格式
  • 文档发现:列出和访问可用的PDF文件

工具

服务器提供两个主要工具:

  • get_document_list:返回数据目录中所有可用PDF文件的列表
  • get_document_text:以Markdown格式提取并返回指定PDF文件的全文内容

安装

确保你有 uv 安装.

克隆存储库:

git clone git@github.com:mlexpertio/mcp-pdf-reader.git
cd mcp-pdf-reader

安装Python:

uv python install 3.12.10

创建并激活虚拟环境:

uv venv
source .venv/bin/activate

安装依赖项:

uv sync

用法

添加PDF文档

将您的PDF文件放在 data/ 目录。服务器将自动检测并通过工具使其可用。

运行MCP服务器

启动MCP服务器:

python server.py

服务器使用stdio传输运行,可以与任何兼容MCP的客户端集成。

开发和测试

使用MCP检查器测试服务器:

mcp dev server.py

这将打开一个web界面,您可以在其中测试可用工具并检查它们的响应。

在VSCode/游标中使用

您可以在编辑器中使用MCP集成。 Tools & Integrations -> New MCP Server 并编辑 mcp.json 文件应包括以下内容:

{
  "mcpServers": {
    "pdf-reader": {
      "command": "/opt/homebrew/bin/uv", // path to your uv binary
      "args": ["run", "--directory", "PATH_TO_YOUR_PROJECT", "server.py"]
    }
  }
}

许可证

有关详细信息,请参阅LICENSE文件。