lightpdf-aipdf-mcp

# LightPDF AI-PDF MCP Server 🚀 基于 **FastMCP** 框架的现代化 PDF 处理工具，提供 22 个专业的文档处理功能。 ## ✨ 项目特色 - **🚀 高效架构**：基于 FastMCP，现代化设计 - **🔒 类型安全**：100% 编译时参数验证 - **⚡ 开发友好**：新工具开发速度提升 300%+ - **🔄 完全兼容**：标准 MCP 协议 100% 兼容 - **🛠️ 功能丰富**：22 个工具涵盖 PDF 处理所有核心功能 ## 🚀 快速开始 ### 安装和启动 ```bash # 安装依赖 uv sync # 启动 stdio 模式（用于 MCP 客户端） python run.py # 启动 SSE 服务器模式（用于 Web 调试） python run.py -p 8000 --sse # 启动 HTTP 服务器模式（用于 HTTP 调试） python run.py -p 8000 ``` ### 验证安装 ```bash # 运行完整测试套件 python test_server.py ``` ## 🛠️ 可用工具（共22个） ### 📄 文档转换 (3个) - `convert_document` - 文档格式转换，支持20+格式互转 - `add_page_numbers` - 为 PDF 添加页码 - `remove_watermark` - 去除 PDF 水印 ### 🔧 PDF编辑 (6个) - `compress_pdf` - PDF 压缩优化 - `merge_pdfs` - 合并多个 PDF - `split_pdf` - 按页面、范围或书签拆分 PDF - `rotate_pdf` - 旋转 PDF 页面 - `unlock_pdf` - 移除 PDF 密码保护 - `protect_pdf` - 为 PDF 添加密码保护 ### 🎨 水印工具 (2个) - `add_text_watermark` - 添加文本水印 - `add_image_watermark` - 添加图片水印 ### 🤖 AI功能 (4个) - `create_pdf` - 基于文本描述生成 PDF - `translate_pdf` - PDF 文档翻译（35种语言） - `ocr_document` - OCR 文字识别 (支持PDF/DOC/PPT/Excel/图片等) - `summarize_document` - 文档摘要生成 ### 🔧 专业工具 (7个) - `remove_margin` - 去除 PDF 白边 - `extract_images` - 提取 PDF 中的图片 - `flatten_pdf` - 扁平化 PDF（表单转静态） - `repair_pdf` - 修复损坏的 PDF - `curve_pdf` - 文字转曲（防止文字提取） - `double_layer_pdf` - 转换为双层 PDF（可搜索） - `delete_pdf_pages` - 删除指定页面 ### 🔒 安全功能 (2个) - `restrict_printing` - 限制 PDF 打印权限 - `resize_pdf` - 调整 PDF 大小和分辨率 - `replace_text` - 替换 PDF 文本内容 ## 📁 项目架构 采用清晰的现代化5层架构： ``` src/lightpdf_aipdf_mcp/ ├── api/ # API层 - FastMCP服务器与适配器 │ ├── server.py # FastMCP主服务器 (22个工具) │ └── adapter.py # 业务逻辑适配器 ├── core/ # 核心层 - 统一业务逻辑 │ └── processor.py # 核心业务处理器 ├── services/ # 服务层 - 具体功能模块 │ ├── converter.py # 文档转换服务 │ ├── editor.py # PDF编辑服务 │ ├── create_pdf.py # PDF创建服务 │ ├── translator.py # 翻译服务 │ ├── summarizer.py # 摘要服务 │ └── ocr.py # OCR服务 ├── models/ …