PDF Tools MCP

一套使用模型上下文协议（MCP）框架构建的全面的PDF操作工具集。

功能

本地PDF操作

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

远程PDF操作

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

安装

通过Smithery安装

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

npx -y @smithery/cli install @danielkennedy1/pdf-tools-mcp --client claude

手动安装

# 克隆仓库
git clone https://github.com/yourusername/pdf-tools-mcp.git
cd pdf-tools-mcp

# 安装依赖
uv pip install -e .

使用

启动MCP服务器：

python -m src.main

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

开发

• 需要Python 3.12+
• 使用MCP框架进行工具注册
• PDF文档使用UUID4文件名存储以保证安全

# 更新依赖
uv pip install -e . --upgrade

# 提交更改（使用常规提交格式）
cz commit

依赖项

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

许可证

MIT。参见LICENSE。 </中文翻译>