MCP Enabled PDF Reader

MCP Enabled PDF Reader

site icon
2025.04.13 0
PythonPDF 阅读器文本提取内容生成
MCP Enabled PDF Reader 是一个基于 Model Context Protocol (MCP) 的服务,提供了一个名为 read_pdf 的工具,用于读取单个 PDF 文档。该服务已通过 Claude Desktop 和 LibreChat with Ollama 测试。虽然可以读取任意大小的 PDF 文件,但传递给模型的 token 数量将是限制因素。
View on GitHub

Overview

基本能力

产品定位

MCP Enabled PDF Reader 是一个用于读取和解析 PDF 文档的工具,旨在为 MCP 框架提供 PDF 内容读取能力。

核心功能

  • 提供 read_pdf 工具,用于读取单个 PDF 文档
  • 支持任意大小的 PDF 文件(受限于模型 token 数量)
  • 兼容 Claude Desktop 和 LibreChat with Ollama

适用场景

  • 需要从 PDF 文档中提取文本内容的场景
  • 在 MCP 框架下处理 PDF 文档的工作流程
  • 与 Claude Desktop 或 LibreChat 等 AI 工具集成使用

工具列表

  • read_pdf: 读取单个 PDF 文档的工具

常见问题解答

  1. 如何获取支持?
  2. 查看文档
  3. 在仓库中提交 issue

使用教程

使用依赖

Windows

  1. 安装 Claude Desktop
  2. 下载 Claude for Desktop
  3. 按照 安装指南 操作

  4. 安装 Python 3.10 或更高版本

  5. python.org 下载安装包
  6. 运行安装程序,勾选 "Add Python to PATH"
  7. 在命令提示符中验证安装:python --version

  8. 安装 uv

  9. 以管理员身份打开命令提示符
  10. 运行:pip install --user uv
  11. 验证安装:uv --version

macOS

  1. 安装 Claude Desktop
  2. 下载 Claude for Desktop
  3. 按照 安装指南 操作

  4. 安装 Python 3.10 或更高版本

  5. 使用 Homebrew:brew install python
  6. 验证安装:python3 --version

  7. 安装 uv

  8. 使用 Homebrew:brew install uv
  9. 或使用:pip3 install --user uv
  10. 验证安装:uv --version

安装教程

claude_desktop_config.json 中添加以下配置:

{
    "mcpServers": {
        "mcp-pdf-reader": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/Safe-Swiss-Cloud-AG/mcp_pdf_reader@main",
                "mcp_pdf_reader"
            ]
        }
    }
}

调试方式

安装完成后,可以通过以下方式验证服务是否正常运行: 1. 检查 uv 是否安装成功:uv --version 2. 确保配置已正确添加到 claude_desktop_config.json 文件中 3. 在 Claude Desktop 或 LibreChat 中尝试使用 read_pdf 功能

许可证

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