MCP ExplorerExplorer

Office Powerpoint Mcp Server

@GongRzheon 21 days ago
141 MIT
FreeCommunity
AI Systems
A MCP (Model Context Protocol) server for PowerPoint manipulation using python-pptx. This server provides tools for creating, editing, and manipulating PowerPoint presentations through the MCP protocol.

Overview

What is Office Powerpoint Mcp Server

Office-PowerPoint-MCP-Server is a Model Context Protocol (MCP) server designed for manipulating PowerPoint presentations using the python-pptx library. It provides tools for creating, editing, and modifying PowerPoint files through the MCP protocol.

Use cases

Use cases include generating automated reports, creating dynamic presentations based on data inputs, customizing slides for specific audiences, and integrating PowerPoint manipulation into larger applications.

How to use

To use Office-PowerPoint-MCP-Server, install it by running the setup script provided in the repository. After installation, you can utilize its features to create and edit PowerPoint presentations programmatically.

Key features

Key features include the ability to round-trip Open XML presentations, add slides, populate text placeholders, insert images, add text boxes, create tables, include auto shapes, manipulate charts, and access core document properties.

Where to use

Office-PowerPoint-MCP-Server can be used in various fields such as education, business presentations, marketing, and any domain where automated PowerPoint generation or editing is required.

Content

Office-PowerPoint-MCP-Server

smithery badge

A comprehensive MCP (Model Context Protocol) server for PowerPoint manipulation using python-pptx. Version 2.0 provides 32 powerful tools organized into 11 specialized modules, offering complete PowerPoint creation, management, and professional design capabilities. The server features a modular architecture with enhanced parameter handling, intelligent operation selection, and comprehensive error handling.


Not so ugly anymore with new slide_layout_templates

截屏2025-06-20 15 53 45

Example

Pormpt

650f4cc5d0f1ea4f3b1580800cb0deb

Output

084f1cf4bc7e4fcd4890c8f94f536c1

Demo’s GIF -> (./public/demo.mp4)

demo

Features

Core PowerPoint Operations

  • Round-trip support for any Open XML presentation (.pptx file) including all elements
  • Template support with automatic theme and layout preservation
  • Multi-presentation management with global state tracking
  • Core document properties management (title, subject, author, keywords, comments)

Content Creation & Management

  • Slide management with flexible layout selection
  • Text manipulation with placeholder population and bullet point creation
  • Advanced text formatting with font, color, alignment, and style controls
  • Text validation with automatic fit checking and optimization suggestions

Visual Elements

  • Image handling with file and base64 input support
  • Image enhancement using Pillow with brightness, contrast, saturation, and filter controls
  • Professional image effects including shadows, reflections, glows, and soft edges
  • Shape creation with 20+ auto shape types (rectangles, ovals, flowchart elements, etc.)
  • Table creation with advanced cell formatting and styling

Charts & Data Visualization

  • Chart support for column, bar, line, and pie charts
  • Data series management with categories and multiple series support
  • Chart formatting with legends, data labels, and titles

Professional Design Features

  • 4 professional color schemes (Modern Blue, Corporate Gray, Elegant Green, Warm Red)
  • Professional typography with Segoe UI font family and size presets
  • Theme application with automatic styling across presentations
  • Gradient backgrounds with customizable directions and color schemes
  • Slide enhancement tools for existing content
  • 25 built-in slide templates with dynamic sizing and visual effects
  • Advanced template features including auto-wrapping, dynamic font sizing, and professional animations

Advanced Features

  • Font analysis and optimization using FontTools
  • Picture effects with 9 different visual effects (shadow, reflection, glow, bevel, etc.)
  • Comprehensive validation with automatic error fixing
  • Template search with configurable directory paths
  • Professional layout calculations with margin and spacing management

Installation

Installing via Smithery

To install PowerPoint Manipulation Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @GongRzhe/Office-PowerPoint-MCP-Server --client claude

Prerequisites

  • Python 3.6 or higher (as specified in pyproject.toml)
  • pip package manager
  • Optional: uvx for package execution without local installation

Installation Options

Option 1: Using the Setup Script (Recommended)

The easiest way to set up the PowerPoint MCP Server is using the provided setup script, which automates the installation process:

python setup_mcp.py

This script will:

  • Check prerequisites
  • Offer installation options:
    • Install from PyPI (recommended for most users)
    • Set up local development environment
  • Install required dependencies
  • Generate the appropriate MCP configuration file
  • Provide instructions for integrating with Claude Desktop

The script offers different paths based on your environment:

  • If you have uvx installed, it will configure using UVX (recommended)
  • If the server is already installed, it provides configuration options
  • If the server is not installed, it offers installation methods

Option 2: Manual Installation

  1. Clone the repository:

    git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
    cd Office-PowerPoint-MCP-Server
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Make the server executable:

    chmod +x ppt_mcp_server.py
    

Usage

Display help text:

python ppt_mcp_server.py -h

Starting the Stdio Server

Run the stdio server:

python ppt_mcp_server.py

Starting the Streamable-Http Server

Run the streamable-http server on port 8000:

python ppt_mcp_server.py --transport http --port 8000

Run in Docker

docker build -t ppt_mcp_server .
docker run -d --rm -p 8000:8000 ppt_mcp_server -t http

MCP Configuration

Option 1: Local Python Server

Add the server to your MCP settings configuration file:

{
  "mcpServers": {
    "ppt": {
      "command": "python",
      "args": [
        "/path/to/ppt_mcp_server.py"
      ],
      "env": {}
    }
  }
}

Option 2: Using UVX (No Local Installation Required)

If you have uvx installed, you can run the server directly from PyPI without local installation:

{
  "mcpServers": {
    "ppt": {
      "command": "uvx",
      "args": [
        "--from",
        "office-powerpoint-mcp-server",
        "ppt_mcp_server"
      ],
      "env": {}
    }
  }
}

🚀 What’s New in v2.0

Comprehensive Tool Suite (32 Tools)

  • Complete PowerPoint manipulation with 32 specialized tools
  • 11 organized modules covering all aspects of presentation creation
  • Enhanced parameter handling with comprehensive validation
  • Intelligent defaults and operation-based interfaces

Built-in Slide Templates

  • 25+ professional slide templates with dynamic features built-in
  • Advanced template system with auto-generation capabilities
  • Auto-sizing text that adapts to content length and container size
  • Professional visual effects including shadows, glows, and gradients
  • Complete presentation generation from template sequences

Modular Architecture

  • 11 specialized modules: presentation, content, structural, professional, template, hyperlink, chart, connector, master, and transition tools
  • Better maintainability with separated concerns
  • Easier extensibility for adding new features
  • Cleaner code structure with shared utilities

Available Tools

The server provides 32 specialized tools organized into the following categories:

Presentation Management (7 tools)

  1. create_presentation - Create new presentations
  2. create_presentation_from_template - Create from templates with theme preservation
  3. open_presentation - Open existing presentations
  4. save_presentation - Save presentations to files
  5. get_presentation_info - Get comprehensive presentation information
  6. get_template_file_info - Analyze template files and layouts
  7. set_core_properties - Set document properties

Content Management (6 tools)

  1. add_slide - Add slides with optional background styling
  2. get_slide_info - Get detailed slide information
  3. populate_placeholder - Populate placeholders with text
  4. add_bullet_points - Add formatted bullet points
  5. manage_text - ✨ Unified text tool (add/format/validate/format_runs)
  6. manage_image - ✨ Unified image tool (add/enhance)

Template Operations (7 tools)

  1. list_slide_templates - Browse available slide layout templates
  2. apply_slide_template - Apply structured layout templates to existing slides
  3. create_slide_from_template - Create new slides using layout templates
  4. create_presentation_from_templates - Create complete presentations from template sequences
  5. get_template_info - Get detailed information about specific templates
  6. auto_generate_presentation - Automatically generate presentations based on topic
  7. optimize_slide_text - Optimize text elements for better readability and fit

Structural Elements (4 tools)

  1. add_table - Create tables with enhanced formatting
  2. format_table_cell - Format individual table cells
  3. add_shape - Add shapes with text and formatting options
  4. add_chart - Create charts with comprehensive customization

Professional Design (3 tools)

  1. apply_professional_design - ✨ Unified design tool (themes/slides/enhancement)
  2. apply_picture_effects - ✨ Unified effects tool (9+ effects combined)
  3. manage_fonts - ✨ Unified font tool (analyze/optimize/recommend)

Specialized Features (5 tools)

  1. manage_hyperlinks - Complete hyperlink management (add/remove/list/update)
  2. manage_slide_masters - Access and manage slide master properties and layouts
  3. add_connector - Add connector lines/arrows between points on slides
  4. update_chart_data - Replace existing chart data with new categories and series
  5. manage_slide_transitions - Basic slide transition management

🌟 Key Unified Tools

manage_text - All-in-One Text Management

# Add text box
manage_text(slide_index=0, operation="add", text="Hello World", font_size=24)

# Format existing text
manage_text(slide_index=0, operation="format", shape_index=0, bold=True, color=[255,0,0])

# Validate text fit with auto-fix
manage_text(slide_index=0, operation="validate", shape_index=0, validation_only=False)

manage_image - Complete Image Handling

# Add image with enhancement
manage_image(slide_index=0, operation="add", image_source="logo.png", 
            enhancement_style="presentation")

# Enhance existing image
manage_image(slide_index=0, operation="enhance", image_source="photo.jpg",
            brightness=1.2, contrast=1.1, saturation=1.3)

apply_picture_effects - Multiple Effects in One Call

# Apply combined effects
apply_picture_effects(slide_index=0, shape_index=0, effects={
    "shadow": {"blur_radius": 4.0, "color": [128,128,128]},
    "glow": {"size": 5.0, "color": [0,176,240]},
    "rotation": {"rotation": 15.0}
})

apply_professional_design - Theme & Design Management

# Add professional slide
apply_professional_design(operation="slide", slide_type="title_content", 
                         color_scheme="modern_blue", title="My Presentation")

# Apply theme to entire presentation  
apply_professional_design(operation="theme", color_scheme="corporate_gray")

# Enhance existing slide
apply_professional_design(operation="enhance", slide_index=0, color_scheme="elegant_green")

Examples

Creating a New Presentation

# Create a new presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation",
    arguments={}
)
presentation_id = result["presentation_id"]

# Add a title slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,  # Title slide layout
        "title": "My Presentation",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# Populate subtitle placeholder
result = use_mcp_tool(
    server_name="ppt",
    tool_name="populate_placeholder",
    arguments={
        "slide_index": slide_index,
        "placeholder_idx": 1,  # Subtitle placeholder
        "text": "Created with PowerPoint MCP Server",
        "presentation_id": presentation_id
    }
)

# Save the presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "my_presentation.pptx",
        "presentation_id": presentation_id
    }
)

Creating a Professional Presentation with v2.0

# Create a professional slide with modern styling - CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_professional_design",
    arguments={
        "operation": "slide",
        "slide_type": "title_content",
        "color_scheme": "modern_blue",
        "title": "Quarterly Business Review",
        "content": [
            "Revenue increased by 15% compared to last quarter",
            "Customer satisfaction scores reached all-time high of 94%",
            "Successfully launched 3 new product features",
            "Expanded team by 12 new talented professionals"
        ]
    }
)

# Apply professional theme to entire presentation - SAME TOOL, DIFFERENT OPERATION
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_professional_design",
    arguments={
        "operation": "theme",
        "color_scheme": "modern_blue",
        "apply_to_existing": True
    }
)

# Add slide with gradient background - ENHANCED ADD_SLIDE
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 0,
        "background_type": "professional_gradient",
        "color_scheme": "modern_blue",
        "gradient_direction": "diagonal"
    }
)

Working with Built-in Slide Templates (New in v2.0)

# List all available slide templates with their features
result = use_mcp_tool(
    server_name="ppt",
    tool_name="list_slide_templates",
    arguments={}
)

# Apply a professional template to an existing slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_slide_template",
    arguments={
        "slide_index": 0,
        "template_id": "title_slide",
        "color_scheme": "modern_blue",
        "content_mapping": {
            "title": "Quarterly Business Review",
            "subtitle": "Q4 2024 Results",
            "author": "Leadership Team"
        }
    }
)

# Create a new slide using a template
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_slide_from_template",
    arguments={
        "template_id": "text_with_image",
        "color_scheme": "elegant_green",
        "content_mapping": {
            "title": "Our Revolutionary Solution",
            "content": "• 250% increase in efficiency\n• 98% customer satisfaction\n• Industry-leading performance"
        },
        "image_paths": {
            "supporting": "path/to/product_image.jpg"
        }
    }
)

# Generate a complete presentation from multiple templates
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation_from_templates",
    arguments={
        "template_sequence": [
            {
                "template_id": "title_slide",
                "content": {
                    "title": "2024 Annual Report",
                    "subtitle": "Growth and Innovation",
                    "author": "Executive Team"
                }
            },
            {
                "template_id": "key_metrics_dashboard",
                "content": {
                    "metric_1_value": "94%",
                    "metric_2_value": "$2.4M",
                    "metric_3_value": "247"
                }
            },
            {
                "template_id": "before_after_comparison",
                "content": {
                    "content_left": "Manual processes taking hours",
                    "content_right": "Automated workflows in minutes"
                }
            }
        ],
        "color_scheme": "modern_blue"
    }
)

Enhanced Image Management with v2.0

# Add image with automatic enhancement - CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_image",
    arguments={
        "slide_index": 1,
        "operation": "add",
        "image_source": "company_logo.png",
        "left": 1.0,
        "top": 1.0,
        "width": 3.0,
        "height": 2.0,
        "enhancement_style": "presentation"
    }
)

# Apply multiple picture effects at once - CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="apply_picture_effects",
    arguments={
        "slide_index": 1,
        "shape_index": 0,
        "effects": {
            "shadow": {
                "shadow_type": "outer",
                "blur_radius": 4.0,
                "distance": 3.0,
                "direction": 315.0,
                "color": [128, 128, 128],
                "transparency": 0.6
            },
            "glow": {
                "size": 5.0,
                "color": [0, 176, 240],
                "transparency": 0.4
            }
        }
    }
)

Advanced Text Management with v2.0

# Add and format text in one operation - CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "add",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0,
        "height": 1.5,
        "text": "Welcome to Our Quarterly Review",
        "font_size": 32,
        "font_name": "Segoe UI",
        "bold": True,
        "color": [0, 120, 215],
        "alignment": "center",
        "auto_fit": True
    }
)

# Validate and fix text fit issues - SAME TOOL, DIFFERENT OPERATION
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "validate",
        "shape_index": 0,
        "validation_only": False,  # Auto-fix enabled
        "min_font_size": 10,
        "max_font_size": 48
    }
)

Creating a Presentation from Template

# First, inspect a template to see its layouts and properties
result = use_mcp_tool(
    server_name="ppt",
    tool_name="get_template_info",
    arguments={
        "template_path": "company_template.pptx"
    }
)
template_info = result

# Create a new presentation from the template
result = use_mcp_tool(
    server_name="ppt",
    tool_name="create_presentation_from_template",
    arguments={
        "template_path": "company_template.pptx"
    }
)
presentation_id = result["presentation_id"]

# Add a slide using one of the template's layouts
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # Use layout from template
        "title": "Quarterly Report",
        "presentation_id": presentation_id
    }
)

# Save the presentation
result = use_mcp_tool(
    server_name="ppt",
    tool_name="save_presentation",
    arguments={
        "file_path": "quarterly_report.pptx",
        "presentation_id": presentation_id
    }
)

Adding Advanced Charts and Data Visualization

# Add a chart slide
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_slide",
    arguments={
        "layout_index": 1,  # Content slide layout
        "title": "Sales Data",
        "presentation_id": presentation_id
    }
)
slide_index = result["slide_index"]

# Add a column chart with comprehensive customization
result = use_mcp_tool(
    server_name="ppt",
    tool_name="add_chart",
    arguments={
        "slide_index": slide_index,
        "chart_type": "column",
        "left": 1.0,
        "top": 2.0,
        "width": 8.0,
        "height": 4.5,
        "categories": ["Q1", "Q2", "Q3", "Q4"],
        "series_names": ["2023", "2024"],
        "series_values": [
            [100, 120, 140, 160],
            [110, 130, 150, 170]
        ],
        "has_legend": True,
        "legend_position": "bottom",
        "has_data_labels": True,
        "title": "Quarterly Sales Performance",
        "presentation_id": presentation_id
    }
)

Text Validation and Optimization with v2.0

# Validate text fit and get optimization suggestions - USING CONSOLIDATED TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "validate",
        "shape_index": 0,
        "text": "This is a very long title that might not fit properly in the designated text box area",
        "font_size": 24,
        "validation_only": True
    }
)

# Comprehensive slide validation with automatic fixes - SAME TOOL, AUTO-FIX ENABLED
result = use_mcp_tool(
    server_name="ppt",
    tool_name="manage_text",
    arguments={
        "slide_index": 0,
        "operation": "validate",
        "shape_index": 0,
        "validation_only": False,  # Auto-fix enabled
        "min_font_size": 10,
        "max_font_size": 48
    }
)

Template Support

Working with Templates

The PowerPoint MCP Server provides comprehensive template support for creating presentations from existing template files. This feature enables:

  • Corporate branding with predefined themes, layouts, and styles
  • Consistent presentations across teams and projects
  • Custom slide masters and specialized layouts
  • Pre-configured properties and document settings
  • Flexible template discovery with configurable search paths

Template File Requirements

  • Supported formats: .pptx and .potx files
  • Existing content: Templates can contain existing slides (preserved during creation)
  • Layout availability: All custom layouts and slide masters are accessible
  • Search locations: Configurable via PPT_TEMPLATE_PATH environment variable
  • Default search paths: Current directory, ./templates, ./assets, ./resources

Template Configuration

Set the PPT_TEMPLATE_PATH environment variable to specify custom template directories:

# Unix/Linux/macOS
export PPT_TEMPLATE_PATH="/path/to/templates:/another/path"

# Windows  
set PPT_TEMPLATE_PATH="C:\templates;C:\company_templates"

Template Workflow

  1. Inspect Template: Use get_template_info to analyze available layouts and properties
  2. Create from Template: Use create_presentation_from_template with automatic theme preservation
  3. Use Template Layouts: Reference layout indices from template analysis when adding slides
  4. Maintain Branding: Template themes, fonts, and colors are automatically applied to new content

Professional Color Schemes

The server includes 4 built-in professional color schemes:

  • Modern Blue: Microsoft-inspired blue theme with complementary colors
  • Corporate Gray: Professional grayscale theme with blue accents
  • Elegant Green: Forest green theme with cream and light green accents
  • Warm Red: Deep red theme with orange and yellow accents

Each scheme includes primary, secondary, accent, light, and text colors optimized for business presentations.

🎨 Built-in Slide Templates (New in v2.0)

The PowerPoint MCP Server now includes 25 professional slide templates with advanced dynamic features. All templates support:

Dynamic Features

  • Automatic text sizing based on content length and container dimensions
  • Intelligent text wrapping to fit within specified areas
  • Visual effects including shadows, glows, and outlines
  • Gradient backgrounds with multi-layer compositions
  • Professional animations ready for presentation delivery
  • Interactive hover effects for enhanced user experience
  • Smart content overflow handling with automatic adjustments

Available Template Categories

Title & Introduction Slides

  • title_slide - Dynamic title slide with gradient background and text effects
  • chapter_intro - Section divider with chapter numbering and styling
  • thank_you_slide - Closing slide with contact information and effects

Content Layout Slides

  • text_with_image - Text content with stylized image and interactive elements
  • two_column_text - Two equal columns of text with dynamic sizing
  • two_column_text_images - Two columns with text and corresponding images
  • three_column_layout - Three equal columns with text and images
  • full_image_slide - Large background image with text overlay

Business & Analytics Slides

  • key_metrics_dashboard - Interactive metrics dashboard with animated counters
  • before_after_comparison - Dynamic comparison layout with visual dividers
  • chart_comparison - Two charts side by side for performance comparison
  • data_table_slide - Slide focused on tabular data with professional styling
  • timeline_slide - Horizontal timeline with milestones and effects

Process & Flow Slides

  • process_flow - Step-by-step process visualization with enhanced effects
  • agenda_slide - Table of contents or agenda overview with styling
  • quote_testimonial - Featured quote or customer testimonial with effects

Team & Organization Slides

  • team_introduction - Team member showcase with photos and roles

Template Usage Examples

# Browse all available templates
templates = use_mcp_tool("ppt", "list_slide_templates", {})

# Key templates with their features:
{
  "title_slide": {
    "features": ["Dynamic text sizing", "Gradient backgrounds", "Text effects"],
    "elements": ["title", "subtitle", "author", "decorative_accent"]
  },
  "key_metrics_dashboard": {
    "features": ["Animated counters", "Gradient containers", "Trend visualization"],
    "elements": ["3 metric containers", "trend chart", "insights callout"]
  },
  "before_after_comparison": {
    "features": ["Split gradient background", "VS divider", "Improvement arrow"],
    "elements": ["before/after headers", "comparison content", "improvement metrics"]
  }
}

Color Scheme Integration

All templates work seamlessly with the 4 professional color schemes:

  • modern_blue: Microsoft-inspired theme with dynamic gradients
  • corporate_gray: Professional grayscale with blue accents
  • elegant_green: Forest green with cream and light accents
  • warm_red: Deep red with orange and yellow highlights

Dynamic Content Adaptation

Templates automatically adjust to content:

  • Font sizes scale based on text length (8pt - 44pt range)
  • Line spacing adjusts for readability (1.0x - 1.4x)
  • Text wrapping intelligently breaks lines at optimal points
  • Container sizing adapts to content overflow
  • Visual effects scale appropriately with element sizes

📁 File Structure

Office-PowerPoint-MCP-Server/
├── ppt_mcp_server.py          # Main consolidated server (v2.0)
├── slide_layout_templates.json # 25+ professional slide templates with dynamic features
├── tools/                     # 11 specialized tool modules (32 tools total)
│   ├── __init__.py
│   ├── presentation_tools.py  # Presentation management (7 tools)
│   ├── content_tools.py       # Content & slides (6 tools)
│   ├── template_tools.py      # Template operations (7 tools)
│   ├── structural_tools.py    # Tables, shapes, charts (4 tools)
│   ├── professional_tools.py  # Themes, effects, fonts (3 tools)
│   ├── hyperlink_tools.py     # Hyperlink management (1 tool)
│   ├── chart_tools.py         # Advanced chart operations (1 tool)
│   ├── connector_tools.py     # Connector lines/arrows (1 tool)
│   ├── master_tools.py        # Slide master management (1 tool)
│   └── transition_tools.py    # Slide transitions (1 tool)
├── utils/                     # 7 organized utility modules (68+ functions)
│   ├── __init__.py
│   ├── core_utils.py          # Error handling & safe operations
│   ├── presentation_utils.py  # Presentation management utilities
│   ├── content_utils.py       # Content & slide operations
│   ├── design_utils.py        # Themes, colors, effects & fonts
│   ├── template_utils.py      # Template management & dynamic features
│   └── validation_utils.py    # Text & layout validation
├── setup_mcp.py              # Interactive setup script
├── pyproject.toml            # Updated for v2.0
└── README.md                 # This documentation

🏗️ Architecture Benefits

Modular Design

  • 7 focused utility modules with clear responsibilities
  • 11 organized tool modules for comprehensive coverage
  • 68+ utility functions organized by functionality
  • 32 MCP tools covering all PowerPoint manipulation needs
  • Clear separation of concerns for easier development

Code Organization

  • Logical grouping of related functionality across modules
  • Better discoverability with organized tool categories
  • Improved testability with isolated modules
  • Future extensibility through modular structure

Comprehensive Coverage

  • Complete PowerPoint lifecycle from creation to presentation
  • Advanced template system with auto-generation capabilities
  • Professional design tools with multiple effects and styling options
  • Specialized features including hyperlinks, connectors, and slide masters

Developer Experience

  • Clear responsibility boundaries between modules
  • Easier debugging with smaller, focused files
  • Simpler testing with isolated functionality
  • Enhanced maintainability through separation of concerns

🔄 What’s New in Version 2.0

Enhanced functionality with comprehensive tool coverage! The updated server provides:

New Specialized Tools Added:

  • manage_hyperlinks - Complete hyperlink management for text elements
  • update_chart_data - Advanced chart data replacement and updating
  • add_connector - Connector lines and arrows between slide elements
  • manage_slide_masters - Access to slide master properties and layouts
  • manage_slide_transitions - Basic slide transition management
  • auto_generate_presentation - AI-powered presentation generation
  • optimize_slide_text - Text optimization for better readability

Enhanced Existing Tools:

  • manage_text - Now supports text run formatting with format_runs operation
  • create_presentation_from_templates - Enhanced template sequence processing
  • apply_picture_effects - Expanded effect combinations and options

License

MIT

Tools

No tools

Comments