🎯 PPT-MCP

Pure Node.js PowerPoint MCP Server - Create, analyze, and manage PowerPoint presentations with AI assistance

1 PPT-MCP is a Model Context Protocol (MCP) server that provides comprehensive PowerPoint presentation management capabilities using pure JavaScript/TypeScript. Built with PptxGenJS, the most popular PowerPoint library for Node.js with 3,500+ GitHub stars.

✨ Features

🚀 Pure Node.js Stack

• Zero Python Dependencies - 100% JavaScript/TypeScript implementation
• Cross-Platform - Works on Windows, macOS, and Linux
• Modern Architecture - Built with latest Node.js and TypeScript
• Lightweight - Minimal dependencies, fast startup

📊 Core Capabilities

• 🎨 Create Presentations - Generate professional PowerPoint files with custom templates
• ✏️ Edit Existing Files - Advanced editing capabilities with pptx-automizer for real PowerPoint modification
• 📖 File Analysis - Analyze presentation structure and metadata
• 🔧 Template Support - Basic, Professional, and Modern design templates
• 📁 File Management - Smart file handling and directory management

🎯 AI-Powered Workflow

• Claude Integration - Seamless integration with Claude Desktop
• Natural Language - Create presentations using conversational commands
• Intelligent Templates - AI-suggested layouts and designs
• Batch Operations - Handle multiple presentations efficiently

🚀 Quick Start

Prerequisites

• Node.js 18+
• Claude Desktop (for MCP integration)

Installation

Option 1: NPM Package (Recommended)

npm install -g ppt-mcp

Option 2: From Source

git clone https://github.com/guangxiangdebizi/PPT-MCP.git
cd PPT-MCP
npm install
npm run build

Claude Desktop Configuration

Add to your Claude Desktop config:

Stdio Mode (Local Development)

{
  "mcpServers": {
    "ppt-mcp": {
      "command": "node",
      "args": ["path/to/PPT-MCP/build/index.js"]
    }
  }
}

SSE Mode (Production)

# Install and run with Supergateway
npm install -g supergateway
npx supergateway --stdio "node build/index.js" --port 3100

{
  "mcpServers": {
    "ppt-mcp": {
      "type": "sse",
      "url": "http://localhost:3100/sse",
      "timeout": 600
    }
  }
}

🛠️ Available Tools

1. create_presentation

Create new PowerPoint presentations with customizable options.

Parameters:

• title (required) - Presentation title
• slides (optional) - Number of slides (default: 1)
• output_path (optional) - Custom save location
• template (optional) - Design template: basic, professional, modern

Example:

Create a presentation titled "Q4 Business Review" with 5 slides using the professional template

2. edit_presentation