PPT-MCP

PPT-MCP is a pure JavaScript/TypeScript MCP server that lets you create, analyze, and manage PowerPoint presentations with AI-assisted workflows. It runs on Node.js without Python dependencies and can be extended through configurable MCP clients to suit your automation and integration needs.

How to use

You interact with PPT-MCP through an MCP client or orchestration layer. The server exposes capabilities to generate new presentations, edit existing files, read and analyze slides, and apply AI-driven templates and guidance. Use it to drive batch creation, guided editing, and structured analysis across your presentation library.

How to install

Prerequisites: install Node.js 18 or newer. Ensure you have a working JavaScript/TypeScript runtime environment.

Option 1 — Install the MCP package globally (recommended)

npm install -g ppt-mcp

Option 2 — Install from source and build locally

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

Additional configuration and runtime options

You can run PPT-MCP locally in stdio mode for development or expose it via HTTP for production usage. The following configurations illustrate common patterns you will use with an MCP client.

Local development (stdio) start command shown here is used to run the MCP server directly with Node. Adjust the path to the built entry if your project layout differs.

node path/to/PPT-MCP/build/index.js

Production-style HTTP endpoint can be exposed via a gateway. A typical plan is to run the server behind a gateway that supports MCP and SSE. The accessible endpoint in this setup is the SSE URL.

http://localhost:3100/sse

Security and environment considerations

Limit access to MCP endpoints to trusted clients and enforce network policies. Use environment variables to pass sensitive configuration only when running in a controlled environment.

If you are integrating with a gateway or reverse proxy, ensure proper timeout and security settings are in place to prevent unauthorized access or long-running requests.

Migration and notes

This version is a pure Node.js rewrite designed to provide fast startup, cross-platform consistency, and smooth integration with TypeScript tooling. Some advanced PowerPoint features and complex animations may require manual workflows or hybrid approaches.

Template and workflow references

Templates include basic, professional, and modern designs to streamline presentation styling. AI-assisted guidance helps assemble layouts and content that align with your branding and messaging.

Available tools

create_presentation

Create new PowerPoint presentations with customizable options including title, slide count, output path, and template design.

edit_presentation

Basic editing of existing presentations such as adding slides, text, images, or tables, within the capabilities of the underlying PPT engine.

read_presentation

Analyze and extract information from PowerPoint files, with options for output format and slide ranges.

analyze_presentation

Perform structural and content analysis of presentations, with options for detailed or comprehensive insights.

edit_presentation_enhanced

Enhanced editing workflow with step-by-step guidance, multiple approaches, and best-practice recommendations for editing tasks.