mcpcn-office-powerpoint-mcp-server 2.0.7__py3-none-any.whl → 2.0.8__py3-none-any.whl

{mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info → mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcpcn-office-powerpoint-mcp-server
-Version: 2.0.7
+Version: 2.0.8
 Summary: MCP Server for PowerPoint manipulation using python-pptx - Consolidated Edition
 Project-URL: Homepage, https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
 Project-URL: Bug Tracker, https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git/issues
@@ -30,7 +30,7 @@ License-File: LICENSE
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.6
+Requires-Python: >=3.10
 Requires-Dist: fonttools>=4.0.0
 Requires-Dist: mcp[cli]>=1.3.0
 Requires-Dist: pillow>=8.0.0

{mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info → mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info}/RECORD

@@ -3,7 +3,7 @@ slide_layout_templates.json,sha256=ryA8zIZv6WBwjhBQaJXRWES3uqE7esqqFmXyiPEdauU,1
 tools/__init__.py,sha256=b53px-U7Ny4-FMnAdFLoJMtPxD7lt7DB8ydvcdATCz0,983
 tools/chart_tools.py,sha256=vvXI53gm9_2mfNOiG-qCfwLdqqr2pe_uDXHN9adVsZk,3124
 tools/connector_tools.py,sha256=8cUPAfTZ-5vvooLCVQIWfblMzcFe3cPdh_bG5UezykQ,3402
-tools/content_tools.py,sha256=uoIg7dJNIJEO_NA5QZfDB7cxGGixN6BTOAaxg8Fnmk4,24996
+tools/content_tools.py,sha256=4tuFTPcDNnR3av1sp0ExgUueHVi6B5CzOjBqVscNV5E,28668
 tools/hyperlink_tools.py,sha256=EweAxbYGvOpNpzDxH5DnrFzGMQmnzNGGehEoCCx9d18,5920
 tools/master_tools.py,sha256=05a7ZUEDN5a7ySwG97Sj4UJK7Y0pcCxang553Bh7iOM,4986
 tools/presentation_tools.py,sha256=rnVRYOu4A0Sw97sf8qKBK6-q5dYnK1vO2XNAzN8je4o,7977
@@ -18,8 +18,8 @@ utils/design_utils.py,sha256=vEstbqsBe202PYS4NvqdOLL3Aq5na7G2SBJnY-BYD_g,23761
 utils/presentation_utils.py,sha256=9Y4F0twPvr0srjq53_Szkwxcn7dh06IWy3snRLaMuM8,6262
 utils/template_utils.py,sha256=8iSJcJIgoOmi53TtlRnMwRLTDI84EfSW2PWj8EW3Z1k,44574
 utils/validation_utils.py,sha256=0OiwFE1WZh05ZP-0hLzidyxKSUIJaJ3QrV0_s6FpxZk,11775
-mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/METADATA,sha256=ZCHC_yMRsYUyAJ-5fKfQOEG8kkTcX6DhgbE09dRyKVY,35855
-mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/entry_points.txt,sha256=4iWuiBR6HdlTqSJjCVyqyqVGpSGiD4ssw7LkEzmgvXw,75
-mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/licenses/LICENSE,sha256=A-aSf9c0K2FKh7xtMkSr5Ot76NX8mrdLffsajnmZGKs,1064
-mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/RECORD,,
+mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info/METADATA,sha256=KIJW0ylNPFVOTYOOL-PmAjo0yJMuiJPZOwWxz0SSvqc,35856
+mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info/entry_points.txt,sha256=4iWuiBR6HdlTqSJjCVyqyqVGpSGiD4ssw7LkEzmgvXw,75
+mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info/licenses/LICENSE,sha256=A-aSf9c0K2FKh7xtMkSr5Ot76NX8mrdLffsajnmZGKs,1064
+mcpcn_office_powerpoint_mcp_server-2.0.8.dist-info/RECORD,,

tools/content_tools.py

@@ -492,7 +492,70 @@ def register_content_tools(app: FastMCP, presentations: Dict, get_current_presen
         output_path: Optional[str] = None,
         presentation_id: Optional[str] = None
     ) -> Dict:
-        """Unified image management tool for adding and enhancing images."""
+        """
+        统一的图片处理工具（添加/增强）。
+
+        功能
+        - operation="add"：将图片插入到指定幻灯片位置，支持本地文件或 Base64 图片源。
+        - operation="enhance"：对已有图片文件进行画质增强与风格化处理，输出增强后的图片路径。
+
+        参数
+        - slide_index: int — 目标幻灯片索引（从 0 开始）。
+        - operation: str — "add" 或 "enhance"。
+        - image_source: str —
+          * 当 source_type="file"：本地图片文件路径。
+          * 当 source_type="base64"：图片的 Base64 字符串。
+        - source_type: str — "file" 或 "base64"。
+          * add 支持 "file" 与 "base64"。
+          * enhance 仅支持 "file"（不接受 base64）。
+        - left, top: float — 插入位置（英寸）。
+        - width, height: Optional[float] — 插入尺寸（英寸）。可只提供一项以按比例缩放；都不提供则按图片原始尺寸。
+        - enhancement_style: Optional[str] — "presentation" 或 "custom"。当 operation="add" 且需要自动增强时可用；"presentation" 走预设的专业增强流程。
+        - brightness, contrast, saturation, sharpness: float — 亮度/对比度/饱和度/锐度（默认 1.0，>1 增强，<1 减弱）。
+        - blur_radius: float — 模糊半径（默认 0）。
+        - filter_type: Optional[str] — 过滤器类型（如 "DETAIL"、"SMOOTH" 等，取决于 Pillow 支持）。
+        - output_path: Optional[str] — 增强后图片的输出路径（不传则生成临时文件）。
+        - presentation_id: Optional[str] — 指定演示文稿 ID；不传则使用当前打开的演示文稿。
+
+        返回
+        - operation="add"：
+          * message: str
+          * shape_index: int — 新增形状索引
+          * image_path: str（当 source_type="file" 时返回）
+        - operation="enhance"：
+          * message: str
+          * enhanced_path: str — 增强后图片文件路径
+        - 失败时返回 {"error": str}
+
+        注意事项
+        - 当前不支持直接传入网络 URL。如需使用网络图片，请先下载为本地文件，或转为 Base64 后将 source_type 设为 "base64"。
+        - operation="enhance" 不接受 Base64，必须提供可访问的本地文件路径。
+        - 插入 Base64 图片时，内部会写入临时文件后再插入，操作完成后临时文件会被清理。
+        - slide_index 必须在当前演示文稿的有效范围内，否则将返回错误。
+
+        示例
+        - 插入本地图片：
+            manage_image(slide_index=0, operation="add",
+                         image_source="D:/images/logo.png", source_type="file",
+                         left=1.0, top=1.0, width=3.0)
+
+        - 插入 Base64 图片：
+            manage_image(slide_index=1, operation="add",
+                         image_source="<BASE64字符串>", source_type="base64",
+                         left=2.0, top=1.5, width=4.0, height=2.5)
+
+        - 插入并应用专业增强（演示风格）：
+            manage_image(slide_index=2, operation="add",
+                         image_source="assets/photo.jpg", source_type="file",
+                         enhancement_style="presentation", left=1.0, top=2.0)
+
+        - 增强已有图片文件（自定义参数）：
+            manage_image(slide_index=0, operation="enhance",
+                         image_source="assets/photo.jpg", source_type="file",
+                         brightness=1.2, contrast=1.1, saturation=1.3,
+                         sharpness=1.1, blur_radius=0, filter_type=None,
+                         output_path="assets/photo_enhanced.jpg")
+        """
         pres_id = presentation_id if presentation_id is not None else get_current_presentation_id()
         
         if pres_id is None or pres_id not in presentations: