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

mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/RECORD

@@ -0,0 +1,25 @@
+ppt_mcp_server.py,sha256=IX9oqlVBRpaBIhWJcIwoUQpdAmeKowtBQatHYSEiDU0,14264
+slide_layout_templates.json,sha256=ryA8zIZv6WBwjhBQaJXRWES3uqE7esqqFmXyiPEdauU,107256
+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/hyperlink_tools.py,sha256=EweAxbYGvOpNpzDxH5DnrFzGMQmnzNGGehEoCCx9d18,5920
+tools/master_tools.py,sha256=05a7ZUEDN5a7ySwG97Sj4UJK7Y0pcCxang553Bh7iOM,4986
+tools/presentation_tools.py,sha256=rnVRYOu4A0Sw97sf8qKBK6-q5dYnK1vO2XNAzN8je4o,7977
+tools/professional_tools.py,sha256=1nC45Zx2zV-zbWUwqFhgcejIDyxNdbTfi1kymFi-v88,12109
+tools/structural_tools.py,sha256=0MHdwkpYRj-BqkTF31uavtDoPviNQ4GSQofaQ66WlLg,14444
+tools/template_tools.py,sha256=Iz9TIYF2R42FDPX2usU1xk327shgeVDFt3rgJ1aTch8,23516
+tools/transition_tools.py,sha256=lpWw8dwziNzxvqPcVJsBer2XlkXBAYskkTh6gzwQMRk,3116
+utils/__init__.py,sha256=9GRC7Ms2ZGNlZkZTaFicLO2iaPRcyNkESTaVLV911eg,1698
+utils/content_utils.py,sha256=0nuOSUpx6D84zwbkQIkbAg0esgYtMdikq_WgxuqhoJo,19700
+utils/core_utils.py,sha256=k4sZOdY5XesyrpVDInrBomL07QjuzYP4lnCkxNFwm2A,2113
+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.7.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcpcn-office-powerpoint-mcp-server = ppt_mcp_server:main

mcpcn_office_powerpoint_mcp_server-2.0.7.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GongRzhe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ppt_mcp_server.py

@@ -0,0 +1,450 @@
+#!/usr/bin/env python
+"""
+MCP Server for PowerPoint manipulation using python-pptx.
+Consolidated version with 20 tools organized into multiple modules.
+"""
+import os
+import argparse
+from typing import Dict, Any
+from mcp.server.fastmcp import FastMCP
+
+# import utils  # Currently unused
+from tools import (
+    register_presentation_tools,
+    register_content_tools,
+    register_structural_tools,
+    register_professional_tools,
+    register_template_tools,
+    register_hyperlink_tools,
+    register_chart_tools,
+    register_connector_tools,
+    register_master_tools,
+    register_transition_tools
+)
+
+# Initialize the FastMCP server
+app = FastMCP(
+    name="ppt-mcp-server"
+)
+
+# Global state to store presentations in memory
+presentations = {}
+current_presentation_id = None
+
+# Template configuration
+def get_template_search_directories():
+    """
+    Get list of directories to search for templates.
+    Uses environment variable PPT_TEMPLATE_PATH if set, otherwise uses default directories.
+    
+    Returns:
+        List of directories to search for templates
+    """
+    template_env_path = os.environ.get('PPT_TEMPLATE_PATH')
+    
+    if template_env_path:
+        # If environment variable is set, use it as the primary template directory
+        # Support multiple paths separated by colon (Unix) or semicolon (Windows)
+        import platform
+        separator = ';' if platform.system() == "Windows" else ':'
+        env_dirs = [path.strip() for path in template_env_path.split(separator) if path.strip()]
+        
+        # Verify that the directories exist
+        valid_env_dirs = []
+        for dir_path in env_dirs:
+            expanded_path = os.path.expanduser(dir_path)
+            if os.path.exists(expanded_path) and os.path.isdir(expanded_path):
+                valid_env_dirs.append(expanded_path)
+        
+        if valid_env_dirs:
+            # Add default fallback directories
+            return valid_env_dirs + ['.', './templates', './assets', './resources']
+        else:
+            print(f"Warning: PPT_TEMPLATE_PATH directories not found: {template_env_path}")
+    
+    # Default search directories when no environment variable or invalid paths
+    return ['.', './templates', './assets', './resources']
+
+# ---- Helper Functions ----
+
+def get_current_presentation():
+    """Get the current presentation object or raise an error if none is loaded."""
+    if current_presentation_id is None or current_presentation_id not in presentations:
+        raise ValueError("No presentation is currently loaded. Please create or open a presentation first.")
+    return presentations[current_presentation_id]
+
+def get_current_presentation_id():
+    """Get the current presentation ID."""
+    return current_presentation_id
+
+def set_current_presentation_id(pres_id):
+    """Set the current presentation ID."""
+    global current_presentation_id
+    current_presentation_id = pres_id
+
+def validate_parameters(params):
+    """
+    Validate parameters against constraints.
+    
+    Args:
+        params: Dictionary of parameter name: (value, constraints) pairs
+        
+    Returns:
+        (True, None) if all valid, or (False, error_message) if invalid
+    """
+    for param_name, (value, constraints) in params.items():
+        for constraint_func, error_msg in constraints:
+            if not constraint_func(value):
+                return False, f"Parameter '{param_name}': {error_msg}"
+    return True, None
+
+def is_positive(value):
+    """Check if a value is positive."""
+    return value > 0
+
+def is_non_negative(value):
+    """Check if a value is non-negative."""
+    return value >= 0
+
+def is_in_range(min_val, max_val):
+    """Create a function that checks if a value is in a range."""
+    return lambda x: min_val <= x <= max_val
+
+def is_in_list(valid_list):
+    """Create a function that checks if a value is in a list."""
+    return lambda x: x in valid_list
+
+def is_valid_rgb(color_list):
+    """Check if a color list is a valid RGB tuple."""
+    if not isinstance(color_list, list) or len(color_list) != 3:
+        return False
+    return all(isinstance(c, int) and 0 <= c <= 255 for c in color_list)
+
+def add_shape_direct(slide, shape_type: str, left: float, top: float, width: float, height: float) -> Any:
+    """
+    Add an auto shape to a slide using direct integer values instead of enum objects.
+    
+    This implementation provides a reliable alternative that bypasses potential 
+    enum-related issues in the python-pptx library.
+    
+    Args:
+        slide: The slide object
+        shape_type: Shape type string (e.g., 'rectangle', 'oval', 'triangle')
+        left: Left position in inches
+        top: Top position in inches
+        width: Width in inches
+        height: Height in inches
+        
+    Returns:
+        The created shape
+    """
+    from pptx.util import Inches
+    
+    # Direct mapping of shape types to their integer values
+    # These values are directly from the MS Office VBA documentation
+    shape_type_map = {
+        'rectangle': 1,
+        'rounded_rectangle': 2, 
+        'oval': 9,
+        'diamond': 4,
+        'triangle': 5,  # This is ISOSCELES_TRIANGLE
+        'right_triangle': 6,
+        'pentagon': 56,
+        'hexagon': 10,
+        'heptagon': 11,
+        'octagon': 12,
+        'star': 12,  # This is STAR_5_POINTS (value 12)
+        'arrow': 13,
+        'cloud': 35,
+        'heart': 21,
+        'lightning_bolt': 22,
+        'sun': 23,
+        'moon': 24,
+        'smiley_face': 17,
+        'no_symbol': 19,
+        'flowchart_process': 112,
+        'flowchart_decision': 114,
+        'flowchart_data': 115,
+        'flowchart_document': 119
+    }
+    
+    # Check if shape type is valid before trying to use it
+    shape_type_lower = str(shape_type).lower()
+    if shape_type_lower not in shape_type_map:
+        available_shapes = ', '.join(sorted(shape_type_map.keys()))
+        raise ValueError(f"Unsupported shape type: '{shape_type}'. Available shape types: {available_shapes}")
+    
+    # Get the integer value for the shape type
+    shape_value = shape_type_map[shape_type_lower]
+    
+    # Create the shape using the direct integer value
+    try:
+        # The integer value is passed directly to add_shape
+        shape = slide.shapes.add_shape(
+            shape_value, Inches(left), Inches(top), Inches(width), Inches(height)
+        )
+        return shape
+    except Exception as e:
+        raise ValueError(f"Failed to create '{shape_type}' shape using direct value {shape_value}: {str(e)}")
+
+# ---- Custom presentation management wrapper ----
+
+class PresentationManager:
+    """Wrapper to handle presentation state updates."""
+    
+    def __init__(self, presentations_dict):
+        self.presentations = presentations_dict
+    
+    def store_presentation(self, pres, pres_id):
+        """Store a presentation and set it as current."""
+        self.presentations[pres_id] = pres
+        set_current_presentation_id(pres_id)
+        return pres_id
+
+# ---- Register Tools ----
+
+# Create presentation manager wrapper
+presentation_manager = PresentationManager(presentations)
+
+# Wrapper functions to handle state management
+def create_presentation_wrapper(original_func):
+    """Wrapper to handle presentation creation with state management."""
+    def wrapper(*args, **kwargs):
+        result = original_func(*args, **kwargs)
+        if "presentation_id" in result and result["presentation_id"] in presentations:
+            set_current_presentation_id(result["presentation_id"])
+        return result
+    return wrapper
+
+def open_presentation_wrapper(original_func):
+    """Wrapper to handle presentation opening with state management."""
+    def wrapper(*args, **kwargs):
+        result = original_func(*args, **kwargs)
+        if "presentation_id" in result and result["presentation_id"] in presentations:
+            set_current_presentation_id(result["presentation_id"])
+        return result
+    return wrapper
+
+# Register all tool modules
+register_presentation_tools(
+    app, 
+    presentations, 
+    get_current_presentation_id, 
+    get_template_search_directories
+)
+
+register_content_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+register_structural_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb,
+    add_shape_direct
+)
+
+register_professional_tools(
+    app,
+    presentations,
+    get_current_presentation_id
+)
+
+register_template_tools(
+    app,
+    presentations,
+    get_current_presentation_id
+)
+
+register_hyperlink_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+register_chart_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+
+register_connector_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+register_master_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+register_transition_tools(
+    app,
+    presentations,
+    get_current_presentation_id,
+    validate_parameters,
+    is_positive,
+    is_non_negative,
+    is_in_range,
+    is_valid_rgb
+)
+
+
+# ---- Additional Utility Tools ----
+
+@app.tool()
+def list_presentations() -> Dict:
+    """List all loaded presentations."""
+    return {
+        "presentations": [
+            {
+                "id": pres_id,
+                "slide_count": len(pres.slides),
+                "is_current": pres_id == current_presentation_id
+            }
+            for pres_id, pres in presentations.items()
+        ],
+        "current_presentation_id": current_presentation_id,
+        "total_presentations": len(presentations)
+    }
+
+@app.tool()
+def switch_presentation(presentation_id: str) -> Dict:
+    """Switch to a different loaded presentation."""
+    if presentation_id not in presentations:
+        return {
+            "error": f"Presentation '{presentation_id}' not found. Available presentations: {list(presentations.keys())}"
+        }
+    
+    global current_presentation_id
+    old_id = current_presentation_id
+    current_presentation_id = presentation_id
+    
+    return {
+        "message": f"Switched from presentation '{old_id}' to '{presentation_id}'",
+        "previous_presentation_id": old_id,
+        "current_presentation_id": current_presentation_id
+    }
+
+@app.tool()
+def get_server_info() -> Dict:
+    """Get information about the MCP server."""
+    return {
+        "name": "PowerPoint MCP Server - Enhanced Edition",
+        "version": "2.1.0",
+        "total_tools": 32,  # Organized into 11 specialized modules
+        "loaded_presentations": len(presentations),
+        "current_presentation": current_presentation_id,
+        "features": [
+            "Presentation Management (7 tools)",
+            "Content Management (6 tools)", 
+            "Template Operations (7 tools)",
+            "Structural Elements (4 tools)",
+            "Professional Design (3 tools)",
+            "Specialized Features (5 tools)"
+        ],
+        "improvements": [
+            "32 specialized tools organized into 11 focused modules",
+            "68+ utility functions across 7 organized utility modules",
+            "Enhanced parameter handling and validation",
+            "Unified operation interfaces with comprehensive coverage",
+            "Advanced template system with auto-generation capabilities",
+            "Professional design tools with multiple effects and styling",
+            "Specialized features including hyperlinks, connectors, slide masters",
+            "Dynamic text sizing and intelligent wrapping",
+            "Advanced visual effects and styling",
+            "Content-aware optimization and validation",
+            "Complete PowerPoint lifecycle management",
+            "Modular architecture for better maintainability"
+        ],
+        "new_enhanced_features": [
+            "Hyperlink Management - Add, update, remove, and list hyperlinks in text",
+            "Advanced Chart Data Updates - Replace chart data with new categories and series",
+            "Advanced Text Run Formatting - Apply formatting to specific text runs",
+            "Shape Connectors - Add connector lines and arrows between points",
+            "Slide Master Management - Access and manage slide masters and layouts",
+            "Slide Transitions - Basic transition management (placeholder for future)"
+        ]
+    }
+
+# ---- Main Function ----
+def main(transport: str = "stdio", port: int = 8000):
+    if transport == "http":
+        import asyncio
+        # Set the port for HTTP transport
+        app.settings.port = port
+        # Start the FastMCP server with HTTP transport
+        try:
+            app.run(transport='streamable-http')
+        except asyncio.exceptions.CancelledError:
+            print("Server stopped by user.")
+        except KeyboardInterrupt:
+            print("Server stopped by user.")
+        except Exception as e:
+            print(f"Error starting server: {e}")
+            
+    elif transport == "sse":
+        # Run the FastMCP server in SSE (Server Side Events) mode
+        app.run(transport='sse')
+        
+    else:
+        # Run the FastMCP server
+        app.run(transport='stdio')
+
+if __name__ == "__main__":
+    # Parse command line arguments
+    parser = argparse.ArgumentParser(description="MCP Server for PowerPoint manipulation using python-pptx")
+
+    parser.add_argument(
+        "-t",
+        "--transport",
+        type=str,
+        default="stdio",
+        choices=["stdio", "http", "sse"],
+        help="Transport method for the MCP server (default: stdio)"
+    )
+
+    parser.add_argument(
+        "-p",
+        "--port",
+        type=int,
+        default=8000,
+        help="Port to run the MCP server on (default: 8000)"
+    )
+    args = parser.parse_args()
+    main(args.transport, args.port)