Upload 14 files (#1)

- Upload 14 files (605241ac69e318b4d9f2c684f5c2fa1b3fc8a4f8)

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+mcp_all_tools_templates_effects_demo.pptx filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,14 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+*.bak
+test/
+.DS_Store
+CLAUDE.md

Dockerfile

@@ -0,0 +1,19 @@
+# Generated by https://smithery.ai. See: https://smithery.ai/docs/config#dockerfile
+FROM python:3.10-alpine
+
+# Install system dependencies (if any required, e.g., for pillow)
+RUN apk add --no-cache gcc musl-dev libffi-dev
+
+# Set work directory
+WORKDIR /app
+
+# Copy the application code
+COPY . .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Expose port if needed (not needed for stdio)
+
+# Set the entrypoint to run the MCP server
+ENTRYPOINT ["python", "ppt_mcp_server.py"]

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.

README.md

@@ -1,17 +1,986 @@
----
-title: Auxomators
-emoji: 💬
-colorFrom: yellow
-colorTo: purple
-sdk: gradio
-sdk_version: 5.42.0
-app_file: app.py
-pinned: false
-hf_oauth: true
-hf_oauth_scopes:
-- inference-api
-license: mit
-short_description: ppt builder
----
-
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+# Office-PowerPoint-MCP-Server
+[![smithery badge](https://smithery.ai/badge/@GongRzhe/Office-PowerPoint-MCP-Server)](https://smithery.ai/server/@GongRzhe/Office-PowerPoint-MCP-Server)
+![](https://badge.mcpx.dev?type=server '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**
+
+<img width="1509" alt="截屏2025-06-20 15 53 45" src="https://github.com/user-attachments/assets/197d82cb-017a-4c00-b969-6e40440ffa36" />
+
+----
+
+### Example
+
+#### Pormpt
+
+<img width="1280" alt="650f4cc5d0f1ea4f3b1580800cb0deb" src="https://github.com/user-attachments/assets/90633c97-f373-4c85-bc9c-a1d7b891c344" />
+
+#### Output
+
+<img width="1640" alt="084f1cf4bc7e4fcd4890c8f94f536c1" src="https://github.com/user-attachments/assets/420e63a0-15a4-46d8-b149-1408d23af038" />
+
+#### Demo's GIF -> (./public/demo.mp4)
+
+![demo](./public/demo.gif)
+
+## 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](https://smithery.ai/server/@GongRzhe/Office-PowerPoint-MCP-Server):
+
+```bash
+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:
+
+```bash
+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:
+   ```bash
+   git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
+   cd Office-PowerPoint-MCP-Server
+   ```
+
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+3. Make the server executable:
+   ```bash
+   chmod +x ppt_mcp_server.py
+   ```
+
+## Usage
+
+Display help text:
+```bash
+python ppt_mcp_server.py -h
+```
+
+### Starting the Stdio Server
+
+Run the stdio server:
+
+```bash
+python ppt_mcp_server.py
+```
+
+### Starting the Streamable-Http Server
+
+Run the streamable-http server on port 8000:
+
+```bash
+python ppt_mcp_server.py --transport http --port 8000
+```
+
+Run in Docker
+```bash
+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:
+
+```json
+{
+  "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:
+
+```json
+{
+  "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)**
+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 (8 tools)**
+8. **add_slide** - Add slides with optional background styling
+9. **get_slide_info** - Get detailed slide information
+10. **extract_slide_text** - ✨ **NEW** Extract all text content from a specific slide
+11. **extract_presentation_text** - ✨ **NEW** Extract text content from all slides in presentation
+12. **populate_placeholder** - Populate placeholders with text
+13. **add_bullet_points** - Add formatted bullet points
+14. **manage_text** - ✨ **Unified text tool** (add/format/validate/format_runs)
+15. **manage_image** - ✨ **Unified image tool** (add/enhance)
+
+### **Template Operations (7 tools)**
+16. **list_slide_templates** - Browse available slide layout templates
+17. **apply_slide_template** - Apply structured layout templates to existing slides
+18. **create_slide_from_template** - Create new slides using layout templates
+19. **create_presentation_from_templates** - Create complete presentations from template sequences
+20. **get_template_info** - Get detailed information about specific templates
+21. **auto_generate_presentation** - Automatically generate presentations based on topic
+22. **optimize_slide_text** - Optimize text elements for better readability and fit
+
+### **Structural Elements (4 tools)**
+23. **add_table** - Create tables with enhanced formatting
+24. **format_table_cell** - Format individual table cells
+25. **add_shape** - Add shapes with text and formatting options
+26. **add_chart** - Create charts with comprehensive customization
+
+### **Professional Design (3 tools)**
+27. **apply_professional_design** - ✨ **Unified design tool** (themes/slides/enhancement)
+28. **apply_picture_effects** - ✨ **Unified effects tool** (9+ effects combined)
+29. **manage_fonts** - ✨ **Unified font tool** (analyze/optimize/recommend)
+
+### **Specialized Features (5 tools)**
+30. **manage_hyperlinks** - Complete hyperlink management (add/remove/list/update)
+31. **manage_slide_masters** - Access and manage slide master properties and layouts
+32. **add_connector** - Add connector lines/arrows between points on slides
+33. **update_chart_data** - Replace existing chart data with new categories and series
+34. **manage_slide_transitions** - Basic slide transition management
+
+## 🌟 Key Unified Tools
+
+### **`manage_text`** - All-in-One Text Management
+```python
+# 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
+```python
+# 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
+```python
+# 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
+```python
+# 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
+
+```python
+# 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
+
+```python
+# 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)
+
+```python
+# 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
+
+```python
+# 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
+
+```python
+# 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
+
+```python
+# 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
+
+```python
+# 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
+
+```python
+# 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)
+
+```python
+# 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:
+
+```bash
+# 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**
+
+```python
+# 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

__init__.py

@@ -0,0 +1 @@
+# PowerPoint MCP Server

mcp-config.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "ppt": {
+      "command": "c:\\Office-PowerPoint-MCP-Server\\.venv\\Scripts\\python.exe",
+      "args": [
+        "c:\\Office-PowerPoint-MCP-Server\\ppt_mcp_server.py"
+      ],
+      "env": {
+        "PYTHONPATH": "c:\\Office-PowerPoint-MCP-Server",
+        "PPT_TEMPLATE_PATH": "c:\\Office-PowerPoint-MCP-Server\\templates"
+      }
+    }
+  }
+}

mcp_all_tools_templates_effects_demo.pptx

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e2e1c60e525f71854d83ea313089c7e3850d353c894b6f2cd79703f4e9140ccf
+size 124502

mcp_config_sample.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "word-document-server": {
+      "command": "D:\\BackDataService\\Office-Word-MCP-Server\\.venv\\Scripts\\python.exe",
+      "args": [
+        "D:\\BackDataService\\Office-Word-MCP-Server\\word_server.py"
+      ],
+      "env": {
+        "PYTHONPATH": "D:\\BackDataService\\Office-Word-MCP-Server"
+      }
+    }
+  }
+}

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 = 8001):
+    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=8001,
+        help="Port to run the MCP server on (default: 8001)"
+    )
+    args = parser.parse_args()
+    main(args.transport, args.port)

pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "office-powerpoint-mcp-server"
+version = "2.0.6"
+description = "MCP Server for PowerPoint manipulation using python-pptx - Consolidated Edition"
+readme = "README.md"
+license = {file = "LICENSE"}
+authors = [
+    {name = "GongRzhe", email = "gongrzhe@gmail.com"}
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.6"
+dependencies = [
+    "python-pptx>=0.6.21",
+    "mcp[cli]>=1.3.0",
+    "Pillow>=8.0.0",
+    "fonttools>=4.0.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git"
+"Bug Tracker" = "https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git/issues"
+
+[tool.hatch.build.targets.wheel]
+only-include = ["ppt_mcp_server.py", "tools/", "utils/", "enhanced_slide_templates.json", "slide_layout_templates.json"]
+sources = ["."]
+
+[tool.hatch.build]
+exclude = [
+  "public/demo.mp4",
+  "public/demo.gif",
+  "*.pptx"
+]
+
+[project.scripts]
+ppt_mcp_server = "ppt_mcp_server:main"

requirements.txt

@@ -0,0 +1,4 @@
+mcp[cli]
+python-pptx
+Pillow
+fonttools

setup_mcp.py

@@ -0,0 +1,561 @@
+# Import necessary Python standard libraries
+import os          # For operating with file system, handling files and directory paths
+import json        # For processing JSON format data
+import subprocess  # For creating and managing subprocesses
+import sys         # For accessing Python interpreter related variables and functions
+import platform    # For getting current operating system information
+import shutil      # For checking if executables exist in PATH
+
+def check_prerequisites():
+    """
+    Check if necessary prerequisites are installed
+    
+    Returns:
+        tuple: (python_ok, uv_installed, uvx_installed, ppt_server_installed)
+    """
+    # Check Python version
+    python_version = sys.version_info
+    python_ok = python_version.major >= 3 and python_version.minor >= 6
+    
+    # Check if uv/uvx is installed
+    uv_installed = shutil.which("uv") is not None
+    uvx_installed = shutil.which("uvx") is not None
+    
+    # Check if office-powerpoint-mcp-server is already installed via pip
+    try:
+        result = subprocess.run(
+            [sys.executable, "-m", "pip", "show", "office-powerpoint-mcp-server"],
+            capture_output=True,
+            text=True,
+            check=False
+        )
+        ppt_server_installed = result.returncode == 0
+    except Exception:
+        ppt_server_installed = False
+        
+    return (python_ok, uv_installed, uvx_installed, ppt_server_installed)
+
+def setup_venv():
+    """
+    Function to set up Python virtual environment
+    
+    Features:
+    - Checks if Python version meets requirements (3.6+)
+    - Creates Python virtual environment (if it doesn't exist)
+    - Installs required dependencies in the newly created virtual environment
+    
+    No parameters required
+    
+    Returns: Path to Python interpreter in the virtual environment
+    """
+    # Check Python version
+    python_version = sys.version_info
+    if python_version.major < 3 or (python_version.major == 3 and python_version.minor < 6):
+        print("Error: Python 3.6 or higher is required.")
+        sys.exit(1)
+    
+    # Get absolute path of the directory containing the current script
+    base_path = os.path.abspath(os.path.dirname(__file__))
+    # Set virtual environment directory path
+    venv_path = os.path.join(base_path, '.venv')
+    
+    # Determine pip and python executable paths based on operating system
+    is_windows = platform.system() == "Windows"
+    if is_windows:
+        pip_path = os.path.join(venv_path, 'Scripts', 'pip.exe')
+        python_path = os.path.join(venv_path, 'Scripts', 'python.exe')
+    else:
+        pip_path = os.path.join(venv_path, 'bin', 'pip')
+        python_path = os.path.join(venv_path, 'bin', 'python')
+    
+    # Check if virtual environment already exists and is valid
+    venv_exists = os.path.exists(venv_path)
+    pip_exists = os.path.exists(pip_path)
+    
+    if not venv_exists or not pip_exists:
+        print("Creating new virtual environment...")
+        # Remove existing venv if it's invalid
+        if venv_exists and not pip_exists:
+            print("Existing virtual environment is incomplete, recreating it...")
+            try:
+                shutil.rmtree(venv_path)
+            except Exception as e:
+                print(f"Warning: Could not remove existing virtual environment: {e}")
+                print("Please delete the .venv directory manually and try again.")
+                sys.exit(1)
+        
+        # Create virtual environment
+        try:
+            subprocess.run([sys.executable, '-m', 'venv', venv_path], check=True)
+            print("Virtual environment created successfully!")
+        except subprocess.CalledProcessError as e:
+            print(f"Error creating virtual environment: {e}")
+            sys.exit(1)
+    else:
+        print("Valid virtual environment already exists.")
+    
+    # Double-check that pip exists after creating venv
+    if not os.path.exists(pip_path):
+        print(f"Error: pip executable not found at {pip_path}")
+        print("Try creating the virtual environment manually with: python -m venv .venv")
+        sys.exit(1)
+    
+    # Install or update dependencies
+    print("\nInstalling requirements...")
+    try:
+        # Install mcp package
+        subprocess.run([pip_path, 'install', 'mcp[cli]'], check=True)
+        # Install python-pptx package
+        subprocess.run([pip_path, 'install', 'python-pptx'], check=True)
+        
+        # Also install dependencies from requirements.txt if it exists
+        requirements_path = os.path.join(base_path, 'requirements.txt')
+        if os.path.exists(requirements_path):
+            subprocess.run([pip_path, 'install', '-r', requirements_path], check=True)
+        
+        
+        print("Requirements installed successfully!")
+    except subprocess.CalledProcessError as e:
+        print(f"Error installing requirements: {e}")
+        sys.exit(1)
+    except FileNotFoundError:
+        print(f"Error: Could not execute {pip_path}")
+        print("Try activating the virtual environment manually and installing requirements:")
+        if is_windows:
+            print(f".venv\\Scripts\\activate")
+        else:
+            print("source .venv/bin/activate")
+        print("pip install mcp[cli] python-pptx")
+        sys.exit(1)
+    
+    return python_path
+
+def generate_mcp_config_local(python_path):
+    """
+    Generate MCP configuration for locally installed office-powerpoint-mcp-server
+    
+    Parameters:
+    - python_path: Path to Python interpreter in the virtual environment
+    
+    Returns: Path to the generated config file
+    """
+    # Get absolute path of the directory containing the current script
+    base_path = os.path.abspath(os.path.dirname(__file__))
+    
+    # Path to PowerPoint Server script
+    server_script_path = os.path.join(base_path, 'ppt_mcp_server.py')
+    
+    # Path to templates directory
+    templates_path = os.path.join(base_path, 'templates')
+    
+    # Create MCP configuration dictionary
+    config = {
+        "mcpServers": {
+            "ppt": {
+                "command": python_path,
+                "args": [server_script_path],
+                "env": {
+                    "PYTHONPATH": base_path,
+                    "PPT_TEMPLATE_PATH": templates_path
+                }
+            }
+        }
+    }
+    
+    # Save configuration to JSON file
+    config_path = os.path.join(base_path, 'mcp-config.json')
+    with open(config_path, 'w') as f:
+        json.dump(config, f, indent=2)  # indent=2 gives the JSON file good formatting
+    
+    return config_path
+
+def generate_mcp_config_uvx():
+    """
+    Generate MCP configuration for PyPI-installed office-powerpoint-mcp-server using UVX
+    
+    Returns: Path to the generated config file
+    """
+    # Get absolute path of the directory containing the current script
+    base_path = os.path.abspath(os.path.dirname(__file__))
+    
+    # Path to templates directory (optional for UVX installs)
+    templates_path = os.path.join(base_path, 'templates')
+    
+    # Create MCP configuration dictionary
+    env_config = {}
+    if os.path.exists(templates_path):
+        env_config["PPT_TEMPLATE_PATH"] = templates_path
+    
+    config = {
+        "mcpServers": {
+            "ppt": {
+                "command": "uvx",
+                "args": ["--from", "office-powerpoint-mcp-server", "ppt_mcp_server"],
+                "env": env_config
+            }
+        }
+    }
+    
+    # Save configuration to JSON file
+    config_path = os.path.join(base_path, 'mcp-config.json')
+    with open(config_path, 'w') as f:
+        json.dump(config, f, indent=2)  # indent=2 gives the JSON file good formatting
+    
+    return config_path
+
+def generate_mcp_config_module():
+    """
+    Generate MCP configuration for PyPI-installed office-powerpoint-mcp-server using Python module
+    
+    Returns: Path to the generated config file
+    """
+    # Get absolute path of the directory containing the current script
+    base_path = os.path.abspath(os.path.dirname(__file__))
+    
+    # Path to templates directory (optional for module installs)
+    templates_path = os.path.join(base_path, 'templates')
+    
+    # Create MCP configuration dictionary
+    env_config = {}
+    if os.path.exists(templates_path):
+        env_config["PPT_TEMPLATE_PATH"] = templates_path
+    
+    config = {
+        "mcpServers": {
+            "ppt": {
+                "command": sys.executable,
+                "args": ["-m", "office_powerpoint_mcp_server"],
+                "env": env_config
+            }
+        }
+    }
+    
+    # Save configuration to JSON file
+    config_path = os.path.join(base_path, 'mcp-config.json')
+    with open(config_path, 'w') as f:
+        json.dump(config, f, indent=2)  # indent=2 gives the JSON file good formatting
+    
+    return config_path
+
+def install_from_pypi():
+    """
+    Install office-powerpoint-mcp-server from PyPI
+    
+    Returns: True if successful, False otherwise
+    """
+    print("\nInstalling office-powerpoint-mcp-server from PyPI...")
+    try:
+        subprocess.run([sys.executable, "-m", "pip", "install", "office-powerpoint-mcp-server"], check=True)
+        print("office-powerpoint-mcp-server successfully installed from PyPI!")
+        return True
+    except subprocess.CalledProcessError:
+        print("Failed to install office-powerpoint-mcp-server from PyPI.")
+        return False
+
+def print_config_instructions(config_path):
+    """
+    Print instructions for using the generated config
+    
+    Parameters:
+    - config_path: Path to the generated config file
+    """
+    print(f"\nMCP configuration has been written to: {config_path}")
+    
+    with open(config_path, 'r') as f:
+        config = json.load(f)
+    
+    print("\nMCP configuration for Claude Desktop:")
+    print(json.dumps(config, indent=2))
+    
+    # Provide instructions for adding configuration to Claude Desktop configuration file
+    if platform.system() == "Windows":
+        claude_config_path = os.path.expandvars("%APPDATA%\\Claude\\claude_desktop_config.json")
+    else:  # macOS
+        claude_config_path = os.path.expanduser("~/Library/Application Support/Claude/claude_desktop_config.json")
+    
+    print(f"\nTo use with Claude Desktop, merge this configuration into: {claude_config_path}")
+
+def create_package_structure():
+    """
+    Create necessary package structure and directories
+    """
+    # Get absolute path of the directory containing the current script
+    base_path = os.path.abspath(os.path.dirname(__file__))
+    
+    # Create __init__.py file
+    init_path = os.path.join(base_path, '__init__.py')
+    if not os.path.exists(init_path):
+        with open(init_path, 'w') as f:
+            f.write('# PowerPoint MCP Server')
+        print(f"Created __init__.py at: {init_path}")
+    
+    # Create requirements.txt file
+    requirements_path = os.path.join(base_path, 'requirements.txt')
+    if not os.path.exists(requirements_path):
+        with open(requirements_path, 'w') as f:
+            f.write('mcp[cli]\npython-pptx\n')
+        print(f"Created requirements.txt at: {requirements_path}")
+    
+    # Create templates directory for PowerPoint templates
+    templates_dir = os.path.join(base_path, 'templates')
+    if not os.path.exists(templates_dir):
+        os.makedirs(templates_dir)
+        print(f"Created templates directory at: {templates_dir}")
+        
+        # Create a README file in templates directory
+        readme_path = os.path.join(templates_dir, 'README.md')
+        with open(readme_path, 'w') as f:
+            f.write("""# PowerPoint Templates
+
+This directory is for storing PowerPoint template files (.pptx or .potx) that can be used with the MCP server.
+
+## Usage
+
+1. Place your template files in this directory
+2. Use the `create_presentation_from_template` tool with the template filename
+3. The server will automatically search for templates in this directory
+
+## Supported Formats
+
+- `.pptx` - PowerPoint presentation files
+- `.potx` - PowerPoint template files
+
+## Example
+
+```python
+# Create presentation from template
+result = create_presentation_from_template("company_template.pptx")
+```
+
+The server will search for templates in:
+- Current directory
+- ./templates/ (this directory)
+- ./assets/
+- ./resources/
+""")
+        print(f"Created templates README at: {readme_path}")
+        
+        # Offer to create a sample template
+        create_sample = input("\nWould you like to create a sample template for testing? (y/n): ").lower().strip()
+        if create_sample in ['y', 'yes']:
+            create_sample_template(templates_dir)
+
+def create_sample_template(templates_dir):
+    """
+    Create a sample PowerPoint template for testing
+    
+    Parameters:
+    - templates_dir: Directory where templates are stored
+    """
+    try:
+        # Import required modules for creating a sample template
+        from pptx import Presentation
+        from pptx.util import Inches, Pt
+        from pptx.dml.color import RGBColor
+        from pptx.enum.text import PP_ALIGN
+        
+        print("Creating sample template...")
+        
+        # Create a new presentation
+        prs = Presentation()
+        
+        # Get the title slide layout
+        title_slide_layout = prs.slide_layouts[0]
+        slide = prs.slides.add_slide(title_slide_layout)
+        
+        # Set title and subtitle
+        title = slide.shapes.title
+        subtitle = slide.placeholders[1]
+        
+        title.text = "Sample Company Template"
+        subtitle.text = "Professional Presentation Template\nCreated by PowerPoint MCP Server"
+        
+        # Format title
+        title_paragraph = title.text_frame.paragraphs[0]
+        title_paragraph.font.size = Pt(44)
+        title_paragraph.font.bold = True
+        title_paragraph.font.color.rgb = RGBColor(31, 73, 125)  # Dark blue
+        
+        # Format subtitle
+        for paragraph in subtitle.text_frame.paragraphs:
+            paragraph.font.size = Pt(18)
+            paragraph.font.color.rgb = RGBColor(68, 84, 106)  # Gray blue
+            paragraph.alignment = PP_ALIGN.CENTER
+        
+        # Add a content slide
+        content_slide_layout = prs.slide_layouts[1]
+        content_slide = prs.slides.add_slide(content_slide_layout)
+        
+        content_title = content_slide.shapes.title
+        content_title.text = "Sample Content Slide"
+        
+        # Add bullet points to content
+        content_placeholder = content_slide.placeholders[1]
+        text_frame = content_placeholder.text_frame
+        text_frame.text = "Key Features"
+        
+        # Add bullet points
+        bullet_points = [
+            "Professional theme and colors",
+            "Custom layouts and placeholders", 
+            "Ready for content creation",
+            "Compatible with MCP server tools"
+        ]
+        
+        for point in bullet_points:
+            p = text_frame.add_paragraph()
+            p.text = point
+            p.level = 1
+        
+        # Add a section header slide
+        section_slide_layout = prs.slide_layouts[2] if len(prs.slide_layouts) > 2 else prs.slide_layouts[0]
+        section_slide = prs.slides.add_slide(section_slide_layout)
+        
+        if section_slide.shapes.title:
+            section_slide.shapes.title.text = "Template Features"
+        
+        # Save the sample template
+        template_path = os.path.join(templates_dir, 'sample_template.pptx')
+        prs.save(template_path)
+        
+        print(f"✅ Sample template created: {template_path}")
+        print("   You can now test the template feature with:")
+        print("   • get_template_info('sample_template.pptx')")
+        print("   • create_presentation_from_template('sample_template.pptx')")
+        
+    except ImportError:
+        print("⚠️  Cannot create sample template: python-pptx not installed yet")
+        print("   Run the setup first, then manually create templates in the templates/ directory")
+    except Exception as e:
+        print(f"❌ Failed to create sample template: {str(e)}")
+        print("   You can manually add template files to the templates/ directory")
+
+# Main execution entry point
+if __name__ == '__main__':
+    # Check prerequisites
+    python_ok, uv_installed, uvx_installed, ppt_server_installed = check_prerequisites()
+    
+    if not python_ok:
+        print("Error: Python 3.6 or higher is required.")
+        sys.exit(1)
+    
+    print("PowerPoint MCP Server Setup")
+    print("===========================\n")
+    
+    # Create necessary files
+    create_package_structure()
+    
+    # If office-powerpoint-mcp-server is already installed, offer config options
+    if ppt_server_installed:
+        print("office-powerpoint-mcp-server is already installed via pip.")
+        
+        if uvx_installed:
+            print("\nOptions:")
+            print("1. Generate MCP config for UVX (recommended)")
+            print("2. Generate MCP config for Python module")
+            print("3. Set up local development environment")
+            
+            choice = input("\nEnter your choice (1-3): ")
+            
+            if choice == "1":
+                config_path = generate_mcp_config_uvx()
+                print_config_instructions(config_path)
+            elif choice == "2":
+                config_path = generate_mcp_config_module()
+                print_config_instructions(config_path)
+            elif choice == "3":
+                python_path = setup_venv()
+                config_path = generate_mcp_config_local(python_path)
+                print_config_instructions(config_path)
+            else:
+                print("Invalid choice. Exiting.")
+                sys.exit(1)
+        else:
+            print("\nOptions:")
+            print("1. Generate MCP config for Python module")
+            print("2. Set up local development environment")
+            
+            choice = input("\nEnter your choice (1-2): ")
+            
+            if choice == "1":
+                config_path = generate_mcp_config_module()
+                print_config_instructions(config_path)
+            elif choice == "2":
+                python_path = setup_venv()
+                config_path = generate_mcp_config_local(python_path)
+                print_config_instructions(config_path)
+            else:
+                print("Invalid choice. Exiting.")
+                sys.exit(1)
+    
+    # If office-powerpoint-mcp-server is not installed, offer installation options
+    else:
+        print("office-powerpoint-mcp-server is not installed.")
+        
+        print("\nOptions:")
+        print("1. Install from PyPI (recommended)")
+        print("2. Set up local development environment")
+        
+        choice = input("\nEnter your choice (1-2): ")
+        
+        if choice == "1":
+            if install_from_pypi():
+                if uvx_installed:
+                    print("\nNow generating MCP config for UVX...")
+                    config_path = generate_mcp_config_uvx()
+                else:
+                    print("\nUVX not found. Generating MCP config for Python module...")
+                    config_path = generate_mcp_config_module()
+                print_config_instructions(config_path)
+        elif choice == "2":
+            python_path = setup_venv()
+            config_path = generate_mcp_config_local(python_path)
+            print_config_instructions(config_path)
+        else:
+            print("Invalid choice. Exiting.")
+            sys.exit(1)
+    
+    print("\nSetup complete! You can now use the PowerPoint MCP server with compatible clients like Claude Desktop.")
+    
+    print("\n" + "="*60)
+    print("POWERPOINT MCP SERVER - NEW FEATURES")
+    print("="*60)
+    print("\n📁 Template Support:")
+    print("   • Place PowerPoint templates (.pptx/.potx) in the ./templates/ directory")
+    print("   • Use 'create_presentation_from_template' tool to create presentations from templates")
+    print("   • Use 'get_template_info' tool to inspect template layouts and properties")
+    print("   • Templates preserve branding, themes, and custom layouts")
+    print("   • Template path configured via PPT_TEMPLATE_PATH environment variable")
+    
+    print("\n🔧 Available MCP Tools:")
+    print("   Presentations:")
+    print("   • create_presentation - Create new blank presentation")
+    print("   • create_presentation_from_template - Create from template file")
+    print("   • get_template_info - Inspect template file details")
+    print("   • open_presentation - Open existing presentation")
+    print("   • save_presentation - Save presentation to file")
+    
+    print("\n   Content:")
+    print("   • add_slide - Add slides with various layouts")
+    print("   • add_textbox - Add formatted text boxes")
+    print("   • add_image - Add images from files or base64")
+    print("   • add_table - Add formatted tables")
+    print("   • add_shape - Add various auto shapes")
+    print("   • add_chart - Add column, bar, line, and pie charts")
+    
+    print("\n📚 Documentation:")
+    print("   • Full API documentation available in README.md")
+    print("   • Template usage examples included")
+    print("   • Check ./templates/README.md for template guidelines")
+    
+    print("\n🚀 Quick Start with Templates:")
+    print("   1. Copy your .pptx template to ./templates/")
+    print("   2. Use: create_presentation_from_template('your_template.pptx')")
+    print("   3. Add slides using template layouts")
+    print("   4. Save your presentation")
+    print("\n💡 Custom Template Paths:")
+    print("   • Set PPT_TEMPLATE_PATH environment variable for custom locations")
+    print("   • Supports multiple paths (colon-separated on Unix, semicolon on Windows)")
+    print("   • Example: PPT_TEMPLATE_PATH='/path/to/templates:/path/to/more/templates'")
+    
+    print("\n" + "="*60)

smithery.yaml

@@ -0,0 +1,16 @@
+# Smithery configuration file: https://smithery.ai/docs/config#smitheryyaml
+
+startCommand:
+  type: stdio
+  configSchema:
+    # JSON Schema defining the configuration options for the MCP.
+    {}
+  commandFunction:
+    # A JS function that produces the CLI command based on the given config to start the MCP on stdio.
+    |-
+    (config) => ({
+      command: 'python',
+      args: ['ppt_mcp_server.py'],
+      env: {}
+    })
+  exampleConfig: {}