Office-PowerPoint-MCP-Server

# Office-PowerPoint-MCP-Server [](https://smithery.ai/server/@GongRzhe/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** <img width="1509" alt="截屏2025-06-20 15 53 45" src="https://github.com/user-attachments/assets/197d82cb-017a-4c00-b969-6e40440ffa36" /> ---- ### Example #### Prompt <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)  ## 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 dependen