Office PowerPoint MCP Server

Office-PowerPoint-MCP-Server

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

Example

Pormpt

Output

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

Clone the repository:

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

Install dependencies:
```
pip install -r requirements.txt
```
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 34 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 34 specialized tools organized into the following categories:

Presentation Management (7 tools)

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

Content Management (8 tools)

add_slide - Add slides with optional background styling
get_slide_info - Get detailed slide information
extract_slide_text - ✨ NEW Extract all text content from a specific slide
extract_presentation_text - ✨ NEW Extract text content from all slides in presentation
populate_placeholder - Populate placeholders with text
add_bullet_points - Add formatted bullet points
manage_text - ✨ Unified text tool (add/format/validate/format_runs)
manage_image - ✨ Unified image tool (add/enhance)

Template Operations (7 tools)

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

Structural Elements (4 tools)

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

Professional Design (3 tools)

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

Specialized Features (5 tools)

manage_hyperlinks - Complete hyperlink management (add/remove/list/update)
manage_slide_masters - Access and manage slide master properties and layouts
add_connector - Add connector lines/arrows between points on slides
update_chart_data - Replace existing chart data with new categories and series
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
    }
)

Reading Slide Content with New Text Extraction Tools (v2.1)

# Extract text content from a specific slide - NEW TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="extract_slide_text",
    arguments={
        "slide_index": 0,
        "presentation_id": presentation_id
    }
)

# The result includes:
{
    "success": True,
    "slide_index": 0,
    "text_content": {
        "slide_title": "Quarterly Business Review",
        "placeholders": [
            {
                "shape_index": 1,
                "shape_name": "Subtitle Placeholder 2",
                "text": "Q4 2024 Results",
                "placeholder_type": "SUBTITLE",
                "placeholder_idx": 1
            }
        ],
        "text_shapes": [
            {
                "shape_index": 3,
                "shape_name": "TextBox 4",
                "text": "Revenue increased by 15%"
            }
        ],
        "table_text": [],
        "all_text_combined": "Quarterly Business Review\nQ4 2024 Results\nRevenue increased by 15%"
    },
    "total_text_shapes": 2,
    "has_title": True,
    "has_tables": False
}

# Extract text from all slides in the presentation - NEW TOOL
result = use_mcp_tool(
    server_name="ppt",
    tool_name="extract_presentation_text",
    arguments={
        "presentation_id": presentation_id,
        "include_slide_info": True
    }
)

# The result includes comprehensive text extraction:
{
    "success": True,
    "presentation_id": "pres_123",
    "total_slides": 5,
    "slides_with_text": 4,
    "total_text_shapes": 12,
    "slides_with_titles": 3,
    "slides_with_tables": 1,
    "slides_text": [...],  # Detailed per-slide text content
    "all_presentation_text_combined": "=== SLIDE 1 ===\nTitle Here\nContent here..."
}

# Extract text without additional slide metadata for cleaner output
result = use_mcp_tool(
    server_name="ppt",
    tool_name="extract_presentation_text",
    arguments={
        "presentation_id": presentation_id,
        "include_slide_info": False
    }
)

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

Inspect Template: Use get_template_info to analyze available layouts and properties
Create from Template: Use create_presentation_from_template with automatic theme preservation
Use Template Layouts: Reference layout indices from template analysis when adding slides
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

🔄 What's New in Version 2.1

Text extraction capabilities added! Now you can read content from existing presentations:

New Text Extraction Tools Added:

extract_slide_text - Extract all text content from a specific slide including titles, placeholders, text shapes, and tables
extract_presentation_text - Extract text content from all slides in a presentation with comprehensive statistics and combined output

Key Features of Text Extraction:

Complete text coverage - Extracts from titles, placeholders, text boxes, and table cells
Structured output - Organized by content type (titles, placeholders, shapes, tables)
Presentation-wide analysis - Statistics on text distribution across slides
Flexible output options - Individual slide content or combined presentation text
Error handling - Graceful handling of slides that cannot be processed

License

MIT

Office PowerPoint MCP Server