mcpField
P
PDF Tools MCP

PDF Tools MCP

本地服务
github.com/danielkennedy1文件与存储3276 周前更新
代码仓库

关于 PDF Tools MCP

PDF Tools MCP 是基于 MCP 框架构建的 PDF 处理工具集，支持本地与远程 PDF 操作。适用于需要渲染、合并、提取或下载 PDF 的用户。项目以 Python 实现，依赖 PyMuPDF。

主要功能

  1. 01渲染 PDF 页面为图像
  2. 02合并多页为单个长页面
  3. 03提取元数据与文本信息
  4. 04从多个文档组合页面
  5. 05下载远程 PDF 到本地

适用场景

  1. 01在 MCP 客户端中预览 PDF 页面
  2. 02从 PDF 中提取文本与元数据
  3. 03将多个文档的页面合并为一份文档

MCP 相关

该项目是 MCP 服务，通过 MCP 协议注册 PDF 处理工具供客户端调用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "pdf-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

PDF Tools MCP

smithery badge

一套基于 Model Context Protocol（MCP）框架构建的 PDF 操作工具。

功能

本地 PDF 操作
  • 显示：将 PDF 页面渲染为图像
  • 合并：将多个页面合并为一个长页面
  • 元数据：提取文档元数据
  • 文本：提取文本块和详细文本信息
  • 片段：从 PDF 页面创建自由形式或全宽片段
  • 拼接：将多个文档中的页面合并为一个文档
远程 PDF 操作
  • 显示：将远程 PDF 页面渲染为图像
  • 下载：从 URL 获取 PDF 并保存到本地存储

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 PDF Tools：

npx -y @smithery/cli install @danielkennedy1/pdf-tools-mcp --client claude
手动安装
# Clone the repository
git clone https://github.com/yourusername/pdf-tools-mcp.git
cd pdf-tools-mcp

# Install dependencies
uv pip install -e .

使用

启动 MCP 服务：

python -m src.main

该服务通过 MCP 协议提供 PDF 操作端点。

开发

  • 需要 Python 3.12+
  • 使用 MCP 框架注册工具
  • PDF 文档使用 UUID4 文件名存储，以确保安全
# Update dependencies
uv pip install -e . --upgrade

# Commit changes (uses conventional commit format)
cz commit

依赖项

  • MCP Framework
  • PyMuPDF
  • 用于异步操作的 aiohttp/aiofiles
  • 用于文件类型检测的 python-magic-bin

许可证

MIT。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。