eiceblue/spire-presentation-mcp-server

What is Spire.Presentation MCP Server?

The Spire.Presentation MCP Server is a robust solution that empowers AI agents to work with Excel files using the Model Context Protocol (MCP). It is totally independent and doesn't require Microsoft Office to be installed on system. This tool enables AI agents to add or delete, read, and convert PowerPoint Presentation seamlessly

Main Features:

• Convert PowerPoint to PDF, PowerPoint to HTML, PowerPoint to Image, and more with high fidelity.
• Create, modify, and manage PowerPoint presentation
• Manage and control presentation: create smartart, create table, and more.
• Manage shape
• group and ungroup
• Add various chart types
• create a pie chart

How to use Spire.Presentation MCP Server?

Prerequisites

• Python 3.10 or higher

Installation

1. Clone the repository:

git clone https://github.com/eiceblue/spire-presentation-mcp-server
cd spire-presentation-mcp-server

2. Install using uv:

uv pip install -e .

Running the Server

Start the server (default port 8000):

uv run spire-ppt-mcp-server

Custom port (e.g., 8080):

# Bash/Linux/macOS
export FASTMCP_PORT=8080 && uv run spire-ppt-mcp-server

# Windows PowerShell
$env:FASTMCP_PORT = "8080"; uv run spire-ppt-mcp-server

Integration with AI Tools

Cursor IDE

1. Add this configuration to Cursor:

{
  "mcpServers": {
    "ppt": {
      "url": "http://localhost:8000/sse",
      "env": {
        "PPT_FILES_PATH": "/path/to/ppt/files"
      }
    }
  }
}

2. The PowerPoint tools will be available through your AI assistant.

Remote Hosting & Transport Protocols

This server uses Server-Sent Events (SSE) transport protocol. For different use cases:

1. Using with Claude Desktop (requires stdio):

   • Use Supergateway to convert SSE to stdio

2. Hosting Your MCP Server:

   • Remote MCP Server Guide

Environment Variables

Available Tools

The server provides a comprehensive set of PowerPoint manipulation tools. Here are the main categories:

• Basic Operations: Add, or delete slide.
• Data Processing: Create or Edit Tables in PowerPoint Presentations, apply formulas
• Formatting: Apply styles, Save Shapes as Image Files in PowerPoint Presentations
• Advanced Features: Create charts, Create table
• Conversion: Convert PowerPoint to PDF, HTML, image, and more with high fidelity.

See TOOLS.md for complete documentation of all available tools.

FAQ from Spire.Presentation MCP Server?

Q1. Can I use Spire.Presentation MCP Server for any directory?

Yes, Spire.Presentation MCP Serer works for any directory.

Q2. Is Spire.Presentation MCP Server free to use?

Yes, it is licensed under the MIT License, allowing free use and modification.

Q3. What programming languages does Spire.Presentation MCP Server support?

It is built with Python.

License

MIT