EiceblueCloud/spire.presentation-mcp-server

What is Spire.Presenation MCP Server?

The Spire.Presenation 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.Presenation MCP Server?

Prerequisites

• Python 3.10 or higher

Installation

1. Clone the repository:

git clone https://github.com/eiceblue/spire-ppt-mcp-server.git
cd spire-ppt-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.PPT MCP Server?

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

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

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

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

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

It is built with Python.

License

MIT