mcpcn-office-powerpoint-mcp-server 2.0.7__tar.gz → 2.0.8__tar.gz

{mcpcn_office_powerpoint_mcp_server-2.0.7 → mcpcn_office_powerpoint_mcp_server-2.0.8}/PKG-INFO

@@ -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 → mcpcn_office_powerpoint_mcp_server-2.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "mcpcn-office-powerpoint-mcp-server"
-version = "2.0.7"
+version = "2.0.8"
 description = "MCP Server for PowerPoint manipulation using python-pptx - Consolidated Edition"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -16,7 +16,7 @@ classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
 ]
-requires-python = ">=3.6"
+requires-python = ">=3.10"
 dependencies = [
     "python-pptx>=0.6.21",
     "mcp[cli]>=1.3.0",
@@ -32,6 +32,11 @@ dependencies = [
 only-include = ["ppt_mcp_server.py", "tools/", "utils/", "enhanced_slide_templates.json", "slide_layout_templates.json"]
 sources = ["."]
 
+[dependency-groups]
+dev = [
+    "build>=1.3.0",
+]
+
 [tool.hatch.build]
 exclude = [
   "public/demo.mp4",
@@ -40,4 +45,4 @@ exclude = [
 ]
 
 [project.scripts]
-mcpcn-office-powerpoint-mcp-server = "ppt_mcp_server:main"
+mcpcn-office-powerpoint-mcp-server = "ppt_mcp_server:main"

{mcpcn_office_powerpoint_mcp_server-2.0.7 → mcpcn_office_powerpoint_mcp_server-2.0.8}/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: