mcp-ppt

This MCP server enables dynamic creation, editing, and saving of PowerPoint presentations. Users can effortlessly add slides, images, tables, and other elements by simply chatting with a large language model, streamlining the entire workflow.

GitHub Stars

53

User Rating

Not Rated

Favorites

0

Views

32

Forks

11

Issues

0

Installation
Difficulty
Intermediate
Estimated Time
10-20 minutes
Requirements
Python 3.6以上
python-pptx 最新版

Installation

Installation

Prerequisites

Required software and versions are as follows:
Python: 3.6 or higher
python-pptx: Latest version

Installation Steps

1. Clone Repository

bash
git clone https://github.com/ltc6539/mcp-ppt.git
cd mcp-ppt

2. Create a Virtual Environment (Optional but Recommended)

bash
python3 -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

3. Add MCP to your project dependencies

bash
uv add "mcp[cli]"
uv run mcp

4. Install in Claude Desktop

bash
mcp install server-local.py

5. Test with MCP Inspector

bash
mcp dev server-local.py

Troubleshooting

If errors occur during server startup, check the full path to the uv executable by running which uv on MacOS/Linux or where uv on Windows.

Configuration

Configuration

Basic Configuration

Claude Desktop Setup

Edit ~/.config/claude-desktop/claude_desktop_config.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
json
{
  "mcpServers": {
    "mcp-ppt": {
      "command": "python",
      "args": ["server-local.py"]
    }
  }
}

Environment Variables

Set the following environment variables as needed:
bash
export API_KEY="your-api-key"
export DEBUG="true"

Security Settings

Store API keys in environment variables or secure configuration files
Set appropriate file access permissions
Adjust logging levels

Configuration Example

json
{
  "mcpServers": {
    "mcp-ppt": {
      "command": "python",
      "args": ["server-local.py"],
      "env": {
        "DEBUG": "true"
      }
    }
  }
}

Examples

Examples

Basic Usage

Here are basic usage examples for the MCP server:

Using with Claude Desktop

1Verify MCP Server Startup
Open Claude Desktop and confirm that the configuration has been loaded correctly.
2Execute Basic Commands

   Available tools from this MCP server:
   - mcp-ppt: Tool for generating PowerPoint presentations
   

Programmatic Usage

python
import requests

def call_mcp_tool(tool_name, params):
    response = requests.post(
        'http://localhost:3000/mcp/call',
        json={
            'tool': tool_name,
            'parameters': params
        }
    )
    return response.json()

Usage example

result = call_mcp_tool('createPresentation', { 'title': 'New Presentation' }) print(result)

Use Cases

Automatic generation of business presentations: Users can input topics to automatically create relevant slides.
Creation of educational materials: Teachers can input lesson content to generate slides for teaching materials.
Creation of project reports: Users can input progress updates to automatically generate presentations for reporting.
Creation of marketing materials: Users can input product information to generate promotional slides.

Additional Resources