Hrithik-s-Raj/PptxGenJS-mcp-server

PptxGenJS MCP Server

A production-ready Model Context Protocol (MCP) server that provides PowerPoint presentation creation capabilities through PptxGenJS. This allows any LLM to create, modify, and export PowerPoint presentations programmatically.

Features

• Create Presentations: Generate new PowerPoint presentations with custom metadata
• Manage Slides: Add and organize slides with various layouts
• Rich Content: Add text, shapes, images, tables, and charts
• Multiple Chart Types: Support for bar, line, pie, doughnut, area, and scatter charts
• Flexible Formatting: Extensive formatting options for text, shapes, and other elements
• File Export: Save presentations to .pptx format
• Session Management: Maintain multiple presentations in memory simultaneously

Installation

npm install
npm run build

Usage

Development Mode

Run the server in development mode with auto-reload:

npm run dev

Production Mode

Build and run the compiled version:

npm run build
node dist/index.js

MCP Inspector

Test the server using the MCP Inspector:

npm run inspector

Available Tools

1. create_presentation

Create a new PowerPoint presentation.

Parameters:

• id (optional): Custom presentation ID
• title (optional): Presentation title
• author (optional): Author name
• subject (optional): Subject
• company (optional): Company name

Returns: Presentation ID for subsequent operations

2. add_slide

Add a new slide to a presentation.

Parameters:

• presentationId (required): The presentation ID
• layout (optional): Slide layout name

Returns: Slide number

3. add_text

Add text to a slide with formatting options.

Parameters:

• presentationId (required): The presentation ID
• slideNumber (required): Target slide (1-based)
• text (required): Text content
• x, y, w, h: Position and size in inches
• fontSize: Font size in points
• bold, italic: Text styling
• color: Text color (hex format)
• align: Text alignment (left, center, right, justify)

4. add_shape

Add shapes to slides.

Parameters:

• presentationId (required): The presentation ID
• slideNumber (required): Target slide
• shape (required): Shape type (rect, ellipse, roundRect, triangle, etc.)
• x, y, w, h (required): Position and size
• fill: Fill color (hex)
• line: Line color (hex)
• lineSize: Line thickness

5. add_image

Add images from file paths or URLs.

Parameters:

• presentationId (required): The presentation ID
• slideNumber (required): Target slide
• path (required): File path or URL
• x, y (required): Position
• w, h (optional): Dimensions

6. add_table

Add tables with data.

Parameters:

• presentationId (required): The presentation ID
• slideNumber (required): Target slide
• rows (required): 2D array of cell values
• x, y, w, h: Position and size

7. add_chart

Add charts with data visualization.

Parameters:

• presentationId (required): The presentation ID
• slideNumber (required): Target slide
• chartType (required): bar, line, pie, doughnut, area, scatter
• data (required): Array of data series
• x, y, w, h: Position and size
• title: Chart title

8. save_presentation

Save presentation to file.

Parameters:

• presentationId (required): The presentation ID
• outputPath (required): Output file path (e.g., './output.pptx')

Returns: Full file path

9. list_presentations

List all active presentations in memory.

Returns: Array of presentation metadata

10. delete_presentation

Remove a presentation from memory.

Parameters:

• presentationId (required): The presentation ID to delete

Integration with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "pptxgenjs": {
      "command": "node",
      "args": ["/path/to/pptxgenjs-mcp-server/dist/index.js"]
    }
  }
}

Example Workflow

// 1. Create a presentation
const { presentationId } = await create_presentation({
  title: "Q4 Business Review",
  author: "John Doe",
  company: "Acme Corp"
});

// 2. Add a title slide
await add_slide({ presentationId });
await add_text({
  presentationId,
  slideNumber: 1,
  text: "Q4 Business Review",
  x: 1,
  y: 2,
  w: 8,
  h: 1,
  fontSize: 44,
  bold: true,
  align: "center"
});

// 3. Add a slide with a chart
await add_slide({ presentationId });
await add_chart({
  presentationId,
  slideNumber: 2,
  chartType: "bar",
  data: [
    {
      name: "Revenue",
      labels: ["Q1", "Q2", "Q3", "Q4"],
      values: [100, 120, 140, 160]
    }
  ],
  title: "Quarterly Revenue"
});

// 4. Save the presentation
await save_presentation({
  presentationId,
  outputPath: "./Q4-Review.pptx"
});

Architecture

• index.ts: MCP server entry point with request handlers
• presentation-manager.ts: Manages presentation lifecycle and state
• tool-handler.ts: Implements tool execution logic
• tools/index.ts: Tool definitions and schemas

Requirements

• Node.js >= 18.0.0
• TypeScript 5.x
• MCP SDK 1.x
• PptxGenJS 4.x

License

ISC

Contributing

Contributions are welcome! Please ensure all changes maintain backward compatibility and include appropriate tests.