lightpdf-aipdf-mcp 0.1.31__py3-none-any.whl → 0.1.33__py3-none-any.whl

lightpdf_aipdf_mcp/server.py

@@ -158,7 +158,7 @@ async def process_edit_file(
             opacity=extra_params.get("opacity", 0.5),
             deg=extra_params.get("deg", "0"),
             range=extra_params.get("range", ""),
-            layout=extra_params.get("layout", "under"),
+            layout=extra_params.get("layout", "on"),
             font_family=extra_params.get("font_family"),
             font_size=extra_params.get("font_size"),
             font_color=extra_params.get("font_color"),
@@ -479,7 +479,7 @@ async def handle_list_tools() -> list[types.Tool]:
                         "type": "string",
                         "description": "布局位置：在内容上(on)或在内容下(under)",
                         "enum": ["on", "under"],
-                        "default": "under"
+                        "default": "on"
                     },
                     "font_family": {
                         "type": "string",
@@ -774,7 +774,7 @@ async def handle_call_tool(name: str, arguments: dict | None) -> list[types.Text
         "opacity": 0.5,
         "deg": "0",  # 更新为"0"以匹配handle_list_tools中的默认值
         "range": "",
-        "layout": "under",  # 添加layout默认值
+        "layout": "on",  # 添加layout默认值
         "image_quantity": 60,
         "split_type": "page",
         "merge_all": 1,

{lightpdf_aipdf_mcp-0.1.31.dist-info → lightpdf_aipdf_mcp-0.1.33.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lightpdf-aipdf-mcp
-Version: 0.1.31
+Version: 0.1.33
 Summary: MCP Server for LightPDF AI-PDF
 Author: LightPDF Team
 License: Proprietary
@@ -18,6 +18,31 @@ Description-Content-Type: text/markdown
 
 LightPDF AI助手 MCP Server 是一个基于 MCP (Model Control Protocol) 的文档格式转换工具，支持多种文档格式之间的相互转换以及PDF的各种处理功能。该工具需要在支持 MCP 功能的软件（如 Cursor）中配置使用。
 
+## 安装指南
+
+### 前提条件
+
+- Node.js 18+ 或 Python 3.12+
+- uv 包管理器
+- 有效的 API 密钥
+
+### 使用 uvx 安装
+
+```bash
+# 安装 uvx（如果尚未安装）
+curl -fsSL https://install.uvx.sh | sh
+
+# 全局安装 LightPDF MCP 包
+uvx install lightpdf-aipdf-mcp@latest
+```
+
+### 使用 pip 安装
+
+```bash
+# 如果使用 pip
+pip install lightpdf-aipdf-mcp
+```
+
 ## 配置说明
 
 在 Cursor 中配置 LightPDF AI助手 MCP Server 工具需要修改 `~/.cursor/mcp.json` 文件。添加以下配置：
@@ -43,10 +68,20 @@ LightPDF AI助手 MCP Server 是一个基于 MCP (Model Control Protocol) 的文
 - `args`: 命令行参数
   - 使用最新版的 `lightpdf-aipdf-mcp` 包
 - `env`: 环境变量配置
-  - `API_KEY`: 你的API密钥
+  - `API_KEY`: 你的API密钥（必填）
 
 配置完成后，重启 Cursor 使配置生效。
 
+## 验证安装
+
+安装和配置完成后，可以在 Cursor 中通过以下命令验证 MCP 服务是否正常工作：
+
+```
+@lightpdf help
+```
+
+如果显示帮助信息，表示安装和配置成功。
+
 ## 功能特性
 
 - 支持多种文档格式的转换
@@ -100,24 +135,47 @@ LightPDF AI助手 MCP Server 是一个基于 MCP (Model Control Protocol) 的文
 
 ## 使用方法
 
-1. 确保你使用的软件支持 MCP 功能（如 Cursor）
-2. 在软件中完成 LightPDF AI助手 MCP Server 工具的配置
-3. 调用相应的工具，指定输入文件和所需参数
-4. 处理完成后，系统会提供结果文件的在线下载链接
+### 基本使用格式
+
+在 Cursor 中，使用 `@lightpdf <命令>` 格式调用工具，例如：
+
+```
+@lightpdf convert_document --files=[{"path": "document.docx"}] --format=pdf
+```
 
 ### 格式转换
-使用 `convert_document` 工具，指定输入文件和目标格式。
-
-### PDF处理功能
-- 去除水印: `remove_watermark`
-- 添加水印: `add_watermark`
-- 添加页码: `add_page_numbers`
-- 拆分PDF: `split_pdf`
-- 合并PDF: `merge_pdfs`
-- 旋转PDF: `rotate_pdf`
-- 压缩PDF: `compress_pdf`
-- 加密PDF: `protect_pdf`
-- 解密PDF: `unlock_pdf`
+使用 `convert_document` 工具，指定输入文件和目标格式：
+
+```
+@lightpdf convert_document --files=[{"path": "document.docx"}] --format=pdf
+```
+
+### PDF处理示例
+
+去除水印:
+```
+@lightpdf remove_watermark --files=[{"path": "document.pdf"}]
+```
+
+添加水印:
+```
+@lightpdf add_watermark --files=[{"path": "document.pdf"}] --text="机密文件" --opacity=0.5
+```
+
+添加页码:
+```
+@lightpdf add_page_numbers --files=[{"path": "document.pdf"}] --start_num=1 --position=6
+```
+
+拆分PDF:
+```
+@lightpdf split_pdf --files=[{"path": "document.pdf"}] --pages="1-5,8,10-15"
+```
+
+合并PDF:
+```
+@lightpdf merge_pdfs --files=[{"path": "doc1.pdf"}, {"path": "doc2.pdf"}]
+```
 
 ## 参数说明
 
@@ -187,22 +245,48 @@ LightPDF AI助手 MCP Server 是一个基于 MCP (Model Control Protocol) 的文
   - `path`: 文件路径或URL
   - `password`: 文档的当前密码（必需）
 
+## 故障排除
+
+### 常见问题解决
+
+1. **服务无法启动**
+   - 检查 API 密钥是否正确
+   - 确认 Cursor 版本是否支持 MCP
+   - 检查 `mcp.json` 配置是否正确
+   - 确保使用Python 3.12+版本
+
+2. **文件处理失败**
+   - 检查文件格式是否受支持
+   - 确认文件路径是否正确
+   - 验证文件大小是否超出限制（通常为100MB）
+
+3. **转换结果不理想**
+   - 对于复杂格式，可能需要尝试不同的转换参数
+   - 某些特殊排版可能无法完全保留
+
+### 日志查看
+
+如果您遇到问题，请提供完整的错误信息以便获得更好的支持。
+
+## 更新与维护
+
+### 更新 MCP 包
+
+```bash
+uvx install lightpdf-aipdf-mcp@latest
+```
+
+### 获取最新文档
+
+访问官方文档网站获取最新使用说明和API参考。
+
 ## 注意事项
 
-1. 确保有足够的磁盘空间用于文件转换
+1. 确保有足够的网络带宽和磁盘空间
 2. 对于网络URL，确保URL可访问且文件大小在合理范围内
 3. 批量转换时会自动控制并发数，避免过度占用系统资源
 4. 某些格式转换可能需要较长时间，请耐心等待
 5. 水印去除功能仅适用于PDF格式文件
 6. 复杂水印可能无法完全去除，效果取决于水印类型
 7. 所有PDF编辑功能只支持PDF格式的输入文件
-
-## 错误处理
-
-工具会提供详细的错误信息，常见的错误包括：
-
-- API密钥未配置或无效
-- 文件格式不支持
-- 文件不存在或无法访问
-- 网络连接问题
-- PDF密码不正确或文件受保护
+8. 使用Python版本必须是3.12或更高版本

{lightpdf_aipdf_mcp-0.1.31.dist-info → lightpdf_aipdf_mcp-0.1.33.dist-info}/RECORD

@@ -2,8 +2,8 @@ lightpdf_aipdf_mcp/__init__.py,sha256=PPnAgpvJLYLVOTxnHDmJAulFnHJD6wuTwS6tRGjqq6
 lightpdf_aipdf_mcp/common.py,sha256=odXhuSYEgbw3eskjFQKOSv-iVellqK35UI05XWprX8k,6488
 lightpdf_aipdf_mcp/converter.py,sha256=5oTLHxXOiZ9_PDatWiYbgPZ0LFFqE0L4qHvamX3g9lM,11732
 lightpdf_aipdf_mcp/editor.py,sha256=mbCGXd1Xzu-ibDWJnn11fOP5Xlf1Vqxi0yQ8Vs_yUKg,21787
-lightpdf_aipdf_mcp/server.py,sha256=CSNSjHDwpc8UHcWxYX6bc5Xsx57KM2CBdSEu3KmiY9w,35707
-lightpdf_aipdf_mcp-0.1.31.dist-info/METADATA,sha256=Mx_Ei8cRP3eLSD02e9G5hN3XNoC0i7DNV-w0wkPgVVg,6449
-lightpdf_aipdf_mcp-0.1.31.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-lightpdf_aipdf_mcp-0.1.31.dist-info/entry_points.txt,sha256=X7TGUe52N4sYH-tYt0YUGApeJgw-efQlZA6uAZmlmr4,63
-lightpdf_aipdf_mcp-0.1.31.dist-info/RECORD,,
+lightpdf_aipdf_mcp/server.py,sha256=Ho7pSXa1iCD7LuAnC3uNBjYT5iwYSfr18WwmuVSpXSQ,35698
+lightpdf_aipdf_mcp-0.1.33.dist-info/METADATA,sha256=gO3sk8IRknV4njsRtGo6w_X1HLeggu2wskbuyH9-e1U,7932
+lightpdf_aipdf_mcp-0.1.33.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+lightpdf_aipdf_mcp-0.1.33.dist-info/entry_points.txt,sha256=X7TGUe52N4sYH-tYt0YUGApeJgw-efQlZA6uAZmlmr4,63
+lightpdf_aipdf_mcp-0.1.33.dist-info/RECORD,,