PPTX Generator MCP Server
Model Context Protocol (MCP) server for generating professional PowerPoint presentations from Markdown.
Transform your lesson plans and documentation into beautiful PPTX presentations with support for:
✅ Inline code with monospace formatting
✅ Code blocks with syntax highlighting background
✅ Tables with styled headers
✅ Bold text and mixed formatting
✅ Bullet lists with proper indentation
✅ Mixed content slides (bullets + code + tables)
✅ Custom branding (logos, colors, instructor info)
📋 Table of Contents
🔧 Requirements
Check your Node.js version:
📦 Installation
Method 1: Quick Install (Recommended)
1. Clone the repository:
2. Run the installation script:
The script will:
Install all dependencies
Install the command globally
Show you the Claude Desktop configuration
3. Configure Claude Desktop:
The installer will show you what to add. Copy the configuration to:
macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
4. Restart Claude Desktop
✅ Done! The pptx-generator tools are now available in Claude.
Method 2: Manual Install
1. Clone and install dependencies:
2. Install globally:
Or with sudo if needed:
3. Verify installation:
4. Configure Claude Desktop (same as Method 1, step 3)
⚙️ Configuration
Claude Desktop Setup
After installation, configure Claude Desktop to use the MCP server.
macOS/Linux:
Windows:
Add this configuration:
If you have other MCP servers:
Restart Claude Desktop for changes to take effect.
Customization
Customize colors, fonts, and branding by editing config.json in the installation directory.
Find your installation:
Edit config:
Configuration options:
Instructor Information
Institution Details
Colors
Colors are adjusted according to the official Armed Forces of Ukraine brandbook, and the logo is Armed Forces of Ukraine emblem.
Fonts
Font Sizes
After editing config.json:
No need to restart Claude Desktop
Changes apply to next generated presentation
🎯 Usage
In Claude Desktop
Once installed and configured, you can use these tools in Claude:
1. Generate a presentation:
Claude will use the pptx-generator:generate_presentation tool automatically.
2. Get a template:
Uses pptx-generator:get_template tool.
3. View configuration:
Uses pptx-generator:get_config tool.
4. Update instructor:
Uses pptx-generator:update_instructor tool.
Markdown Format
Presentations are created from Markdown with special syntax:
Frontmatter (Required)
Types:
practical- Практичне заняттяlecture- Лекційне заняттяgroup- Групове заняття
Slide Types
Plan Slide:
Divider Slide:
Content Slide:
Table:
Column 1 | Column 2 |
| Description 1 |
| Description 2 |
The -d flag runs in detached mode.
Solution 2: Add npm global bin to PATH
Solution 3: Reinstall
Tools not showing in Claude
Check Claude Desktop config:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.jsonVerify JSON syntax (use JSONLint)
Restart Claude Desktop completely:
Quit Claude Desktop (Cmd+Q on macOS)
Reopen Claude Desktop
Check MCP server logs (if available in Claude Desktop)
Permission denied when installing
Solution: Use sudo
Or install without sudo by configuring npm:
Fonts not displaying correctly
Issue: Custom fonts like JetBrains Mono not showing
Solution: Install the font on your system:
Download JetBrains Mono
Install the font
Restart PowerPoint/Keynote
🔄 Updating
To update to the latest version:
No need to restart Claude Desktop - changes take effect immediately for new presentations.
🗑️ Uninstalling
📖 Additional Resources
MCP Documentation: https://modelcontextprotocol.io/
Claude Desktop: https://claude.ai/download
Markdown Guide: https://www.markdownguide.org/
📝 License
MIT License - See LICENSE file for details
🤝 Contributing
Contributions are welcome! Please:
Fork the repository
Create a feature branch
Submit a pull request
💬 Support
For issues or questions:
Open an issue on GitHub
Check the Troubleshooting section
Made with ❤️ for VITI education