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

tools/__init__.py

@@ -0,0 +1,28 @@
+"""
+Tools package for PowerPoint MCP Server.
+Organizes tools into logical modules for better maintainability.
+"""
+
+from .presentation_tools import register_presentation_tools
+from .content_tools import register_content_tools
+from .structural_tools import register_structural_tools
+from .professional_tools import register_professional_tools
+from .template_tools import register_template_tools
+from .hyperlink_tools import register_hyperlink_tools
+from .chart_tools import register_chart_tools
+from .connector_tools import register_connector_tools
+from .master_tools import register_master_tools
+from .transition_tools import register_transition_tools
+
+__all__ = [
+    "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"
+]

tools/chart_tools.py

@@ -0,0 +1,82 @@
+"""
+Chart data management tools for PowerPoint MCP Server.
+Implements advanced chart data manipulation capabilities.
+"""
+
+from typing import Dict, List, Optional, Any
+from pptx.chart.data import ChartData
+
+def register_chart_tools(app, presentations, get_current_presentation_id, validate_parameters, 
+                          is_positive, is_non_negative, is_in_range, is_valid_rgb):
+    """Register chart data management tools with the FastMCP app."""
+    
+    @app.tool()
+    def update_chart_data(
+        slide_index: int,
+        shape_index: int,
+        categories: List[str],
+        series_data: List[Dict],
+        presentation_id: str = None
+    ) -> Dict:
+        """
+        Replace existing chart data with new categories and series.
+        
+        Args:
+            slide_index: Index of the slide (0-based)
+            shape_index: Index of the chart shape (0-based)
+            categories: List of category names
+            series_data: List of dictionaries with 'name' and 'values' keys
+            presentation_id: Optional presentation ID (uses current if not provided)
+            
+        Returns:
+            Dictionary with operation results
+        """
+        try:
+            # Get presentation
+            pres_id = presentation_id or get_current_presentation_id()
+            if pres_id not in presentations:
+                return {"error": "Presentation not found"}
+            
+            pres = presentations[pres_id]
+            
+            # Validate slide index
+            if not (0 <= slide_index < len(pres.slides)):
+                return {"error": f"Slide index {slide_index} out of range"}
+            
+            slide = pres.slides[slide_index]
+            
+            # Validate shape index
+            if not (0 <= shape_index < len(slide.shapes)):
+                return {"error": f"Shape index {shape_index} out of range"}
+            
+            shape = slide.shapes[shape_index]
+            
+            # Check if shape is a chart
+            if not hasattr(shape, 'has_chart') or not shape.has_chart:
+                return {"error": "Shape is not a chart"}
+            
+            chart = shape.chart
+            
+            # Create new ChartData
+            chart_data = ChartData()
+            chart_data.categories = categories
+            
+            # Add series data
+            for series in series_data:
+                if 'name' not in series or 'values' not in series:
+                    return {"error": "Each series must have 'name' and 'values' keys"}
+                
+                chart_data.add_series(series['name'], series['values'])
+            
+            # Replace chart data
+            chart.replace_data(chart_data)
+            
+            return {
+                "message": f"Updated chart data on slide {slide_index}, shape {shape_index}",
+                "categories": categories,
+                "series_count": len(series_data),
+                "series_names": [s['name'] for s in series_data]
+            }
+            
+        except Exception as e:
+            return {"error": f"Failed to update chart data: {str(e)}"}

tools/connector_tools.py

@@ -0,0 +1,91 @@
+"""
+Connector and line tools for PowerPoint MCP Server.
+Implements connector line/arrow drawing capabilities.
+"""
+
+from typing import Dict, List, Optional, Any
+from pptx.util import Inches, Pt
+from pptx.enum.shapes import MSO_CONNECTOR
+from pptx.dml.color import RGBColor
+
+def register_connector_tools(app, presentations, get_current_presentation_id, validate_parameters, 
+                          is_positive, is_non_negative, is_in_range, is_valid_rgb):
+    """Register connector tools with the FastMCP app."""
+    
+    @app.tool()
+    def add_connector(
+        slide_index: int,
+        connector_type: str,
+        start_x: float,
+        start_y: float,
+        end_x: float,
+        end_y: float,
+        line_width: float = 1.0,
+        color: List[int] = None,
+        presentation_id: str = None
+    ) -> Dict:
+        """
+        Add connector lines/arrows between points on a slide.
+        
+        Args:
+            slide_index: Index of the slide (0-based)
+            connector_type: Type of connector ("straight", "elbow", "curved")
+            start_x: Starting X coordinate in inches
+            start_y: Starting Y coordinate in inches
+            end_x: Ending X coordinate in inches  
+            end_y: Ending Y coordinate in inches
+            line_width: Width of the connector line in points
+            color: RGB color as [r, g, b] list
+            presentation_id: Optional presentation ID (uses current if not provided)
+            
+        Returns:
+            Dictionary with operation results
+        """
+        try:
+            # Get presentation
+            pres_id = presentation_id or get_current_presentation_id()
+            if pres_id not in presentations:
+                return {"error": "Presentation not found"}
+            
+            pres = presentations[pres_id]
+            
+            # Validate slide index
+            if not (0 <= slide_index < len(pres.slides)):
+                return {"error": f"Slide index {slide_index} out of range"}
+            
+            slide = pres.slides[slide_index]
+            
+            # Map connector types
+            connector_map = {
+                'straight': MSO_CONNECTOR.STRAIGHT,
+                'elbow': MSO_CONNECTOR.ELBOW,
+                'curved': MSO_CONNECTOR.CURVED
+            }
+            
+            if connector_type.lower() not in connector_map:
+                return {"error": f"Invalid connector type. Use: {list(connector_map.keys())}"}
+            
+            # Add connector
+            connector = slide.shapes.add_connector(
+                connector_map[connector_type.lower()],
+                Inches(start_x), Inches(start_y),
+                Inches(end_x), Inches(end_y)
+            )
+            
+            # Apply formatting
+            if line_width:
+                connector.line.width = Pt(line_width)
+            
+            if color and is_valid_rgb(color):
+                connector.line.color.rgb = RGBColor(*color)
+            
+            return {
+                "message": f"Added {connector_type} connector to slide {slide_index}",
+                "connector_type": connector_type,
+                "start_point": [start_x, start_y],
+                "end_point": [end_x, end_y],
+                "shape_index": len(slide.shapes) - 1
+            }
+            
+        except Exception as e:
+            return {"error": f"Failed to add connector: {str(e)}"}