PDF Tools MCP

基于 Model Context Protocol (MCP) 框架构建的一套全面的 PDF 处理工具。

功能

本地 PDF 操作

• 显示: 将 PDF 页面渲染为图像
• 合并: 将多个页面合并成一个长页面
• 元数据: 提取文档元数据
• 文本: 提取文本块和详细的文本信息
• 片段: 从 PDF 页面创建自由形式或全宽片段
• 融合: 将来自多个文档的页面合并成一个文档

远程 PDF 操作

• 显示: 将远程 PDF 页面渲染为图像
• 下载: 从 URL 获取 PDF 并保存到本地存储

安装

# 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。