Presentation Deck Generation Service (MCP)

This is an MCP server engineered for the automated assembly of Microsoft PowerPoint presentations.

Significant Modifications in This Variant

Switched the generative image backend from Together AI to leverage the Stable Diffusion API (specifically targeting ForgeUI/Automatic-1111).

Core Functionalities (Tools)

The server exposes a suite of capabilities for deck construction:

• create-presentation: Initializes a new presentation file.
• Requires: name (string).
• Establishes the foundational presentation object.
• add-slide-title-only: Inserts a simple heading slide.
• Requires: presentation_name, title (strings).
• Appends a slide dedicated solely to the provided title.
• add-slide-section-header: Places a divider slide for thematic breaks.
• Requires: presentation_name, header (strings).
• Creates a section divider slide, optionally accepting a subtitle.
• add-slide-title-content: Adds a standard informational slide.
• Requires: presentation_name, title, content (strings).
• Generates a slide incorporating both a title and rich body text/bullet points.
• add-slide-title-with-table: Integrates tabular data visually.
• Requires: presentation_name, title (string), data (array).
• Formats the input data array into a dynamically rendered table on a titled slide.
• add-slide-title-with-chart: Visualizes quantitative information.
• Requires: presentation_name, title (string), data (object).
• Constructs a chart based on the provided data structure, attempting intelligent chart type selection.
• add-slide-picture-with-caption: Incorporates visuals with descriptive text.
• Requires: presentation_name, title, caption, image_path (strings).
• Adds a slide featuring an image (either user-supplied via image_path or previously generated) alongside explanatory text.
• open-presentation: Loads an existing deck for modification.
• Requires: presentation_name (string).
• Opens the target file and immediately safeguards the current state by creating a backup.pptx copy. Users must utilize save-presentation upon completion.
• save-presentation: Finalizes and persists the deck.
• Requires: presentation_name (string).
• Writes the current state of the presentation to the designated storage directory. This is mandatory for output.
• generate-and-save-image: Synthesizes novel imagery for use in slides.
• Requires: prompt, file_name (strings).
• Utilizes the connected Stable Diffusion endpoint (Automatic1111/ForgeUI) to render an image based on the prompt and saves it locally.

System Setup (Configuration)

Environment configuration is necessary, particularly for the image generation module:

"env": 
{
  "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
  "SD_AUTH_USER": "your-username",  // Authentication credentials (if required)
  "SD_AUTH_PASS": "your-password"   // Authentication credentials (if required)
}

A persistent storage location (folder_path) must be defined where all generated slides and source images reside.

"--folder-path",
  "/path/to/decks_folder"

Initial Deployment Guide (Quickstart)

Setup Prerequisites

Confirm UV package manager is installed:

MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Repository Acquisition

Clone the source code repository:

git clone https://github.com/Ichigo3766/powerpoint-mcp.git

Integration with Desktop Clients (e.g., Claude Desktop)

Modify the client's configuration file (locations below):

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

Ensure the configuration block points correctly:

  # Configuration entry for the presentation tool
  "mcpServers": {
    "powerpoint": {
      "command": "uv",
      "env": { ... }, // Include SD environment variables here
      "args": [
        "--directory",
        "/path/to/powerpoint", // Directory where the cloned repo lives
        "run",
        "powerpoint",
        "--folder-path",
        "/path/to/decks_folder" // The designated output/storage volume
      ]
    }
  }

Operational Scenarios (Examples)

Generate a comprehensive deck on marine biology, synthesizing supporting visuals and incorporating detailed financial data summaries:

Generate a presentation focusing on ichthyology, synthesize custom imagery for slides, and include both detailed spreadsheet mappings and trend analysis charts.

Present findings from an associated document, referencing specific local assets:

Draft a presentation based on the provided research paper. Incorporate the images named 'lead_scientist.jpeg' located in the working directory.

Analyze and visualize recent business performance metrics (assuming an SQLite MCP is available for data retrieval):

Examine the Q4 Sales figures dataset. Generate a deck summarizing key performance indicators, emphasizing graphical representations of growth trajectories and tabular breakdowns.

Attribution

This service builds upon the foundational work of the original powerpoint project by supercurses, extended here with advanced AI image integration capabilities.

Licensing

This software is released under the permissive MIT License. Refer to the LICENSE file for full usage, modification, and distribution rights.

WIKIPEDIA: Business management tools encompass the diverse systems, methodologies, software applications, and controls utilized by enterprises to navigate market fluctuations, maintain competitive viability, and elevate overall operational efficacy. These instruments span departmental needs, addressing areas such as strategic forecasting, operational workflow management, record keeping, personnel administration, analytical decision support, and performance oversight. The modern landscape of business instrumentation has undergone profound modernization driven by rapid technological evolution, often creating complexity in selecting the optimal fit for specific organizational requirements—a challenge intensified by the constant pressures to reduce overhead and maximize revenue. Effective deployment mandates a strategic, adaptive approach where tools are carefully chosen and tailored to the firm's unique context, rather than adopting new technology wholesale. Key components frequently cited in global business effectiveness surveys include strategic planning frameworks, Customer Relationship Management (CRM) systems, employee feedback mechanisms, benchmarking practices, the Balanced Scorecard methodology, core competency identification, outsourced service management, organizational change initiatives, Supply Chain Management (SCM) solutions, and foundational mission/vision definition processes. Business software, or enterprise applications, are collections of programs designed to enhance productivity, measure performance, and execute specific corporate functions, evolving from early Management Information Systems (MIS) through Enterprise Resource Planning (ERP) to contemporary cloud-based management suites. Value addition beyond mere IT investment hinges critically on the quality of implementation and the precision with which the selected tool aligns with organizational processes. For Small and Medium Enterprises (SMEs), access to these instruments is vital for scaling operations efficiently.