slidecraft-mcp

Name	slidecraft-mcp JSON
Version	0.1.0 JSON
	download
home_page	None
Summary	SlideCraft MCP - Lightweight presentation generator with LLM-powered content creation
upload_time	2025-08-15 09:54:04
maintainer	None
docs_url	None
author	None
requires_python	>=3.13
license	None
keywords	ascii lightweight llm mcp powerpoint presentations
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # SlideCraft MCP 🚀

A **lightweight** Model Context Protocol server for generating rich presentations using **LLM-powered content generation** instead of heavyweight libraries.

## 🛠️ Available Tools

### 🚀 **LLM-Powered Generation**
- `create_presentation_from_prompt`: Generate complete presentations from single prompts
- `generate_content_llm`: Create slide content using AI (titles, bullets, summaries)
- `create_chart_llm`: Generate ASCII charts with descriptions

### 📝 **Core Presentation Tools**
- `create_presentation`: Create new lightweight presentations  
- `add_slide`: Add slides with layouts
- `add_text`: Insert text content with positioning
- `save_presentation`: Save as lightweight JSON format

### 🎨 **Visual Content (ASCII-Based)**
- `add_infographic`: Create ASCII infographics (process, comparison, timeline, hierarchy)
- `create_chart_llm`: Generate bar, line, pie, scatter charts as ASCII art
- `export_to_html`: Export as HTML slideshow with themes
- `export_to_markdown`: Export as Markdown for documentation

### 📊 **Export & Management**
- `list_presentations`: View all active presentations
- `export_to_html`: Generate themed HTML slideshows
- `export_to_markdown`: Create Markdown documentation

## Overview

This MCP server is designed for **speed, efficiency, and AI-first content creation**. Instead of relying on heavy dependencies like python-pptx or matplotlib, it uses:

- 🤖 **LLM Integration**: Generate complete presentations from prompts
- 🪶 **Zero Heavy Dependencies**: Pure Python with minimal requirements  
- ⚡ **Lightning Fast**: Startup in milliseconds, not seconds
- 📊 **ASCII Visualizations**: Charts and infographics without plotting libraries
- � **Lightweight Storage**: JSON-based data structures
- 🌐 **Multiple Exports**: Markdown, HTML, and structured JSON

## ✨ Key Features

### 🪶 **Ultra-Lightweight Architecture**
- **Zero heavyweight dependencies** - No python-pptx, matplotlib, or PIL
- **Fast startup** - Loads in milliseconds 
- **Minimal memory footprint** - Uses <50MB RAM
- **JSON-based storage** - Lightweight data structures

### 🤖 **LLM-Powered Content Generation**
- **Complete presentation generation** from single prompts
- **Intelligent content creation** - titles, bullets, summaries
- **ASCII-based charts and infographics** - no heavy plotting libraries
- **Template-based enhanced output** with emojis and structure

### 📊 **Rich Media Support (Lightweight)**
- **ASCII art charts** - bar, line, pie, scatter
- **ASCII infographics** - process flows, comparisons, timelines, hierarchies  
- **Multiple export formats** - JSON, Markdown, HTML
- **Themed outputs** - default, dark, minimal, corporate

### ⚡ **Performance Benefits**
- **Instant startup** vs 2-3 seconds for heavy alternatives
- **10x smaller memory usage** compared to traditional solutions
- **No binary dependencies** - pure Python implementation
- **Cross-platform compatibility** without external tools

## Quick Start

### Installation

1. Clone or download this repository
2. Install dependencies:
   ```bash
   uv sync --dev --all-extras
   ```

### Usage

#### Claude Desktop Configuration

Add to your Claude Desktop configuration file:

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

```json
{
  "mcpServers": {
    "slidecraft-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/slidecraft-mcp",
        "run",
        "slidecraft-mcp"
      ]
    }
  }
}
```

#### Direct Usage

```bash
# Run the server
uv run slidecraft-mcp

# For development
uv sync --dev
uv run slidecraft-mcp
```

## 🚀 Quick Usage Examples

### Generate Complete Presentation from Prompt
```bash
# Create entire presentation with LLM
create_presentation_from_prompt({
  "prompt": "Benefits of microservices architecture",
  "slide_count": 5,
  "template": "business"
})
```

### Add ASCII Infographic
```bash
# Add process flow infographic
add_infographic({
  "presentation_id": "abc123",
  "slide_index": 0,
  "infographic_type": "process",
  "data": "Development pipeline: Code → Build → Test → Deploy"
})
```

### Export to Multiple Formats
```bash
# Export as HTML slideshow
export_to_html({
  "presentation_id": "abc123",
  "filename": "my_presentation.html",
  "theme": "corporate"
})

# Export as Markdown documentation  
export_to_markdown({
  "presentation_id": "abc123",
  "filename": "presentation.md"
})
```
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "slidecraft-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13",
    "maintainer_email": null,
    "keywords": "ascii, lightweight, llm, mcp, powerpoint, presentations",
    "author": null,
    "author_email": "SlideCraft MCP Team <team@slidecraft-mcp.dev>",
    "download_url": "https://files.pythonhosted.org/packages/a1/40/df498b6a53f48d2d28c2a453d6e203c1256044de730d06ef6a854a53ae6a/slidecraft_mcp-0.1.0.tar.gz",
    "platform": null,
    "description": "# SlideCraft MCP \ud83d\ude80\n\nA **lightweight** Model Context Protocol server for generating rich presentations using **LLM-powered content generation** instead of heavyweight libraries.\n\n## \ud83d\udee0\ufe0f Available Tools\n\n### \ud83d\ude80 **LLM-Powered Generation**\n- `create_presentation_from_prompt`: Generate complete presentations from single prompts\n- `generate_content_llm`: Create slide content using AI (titles, bullets, summaries)\n- `create_chart_llm`: Generate ASCII charts with descriptions\n\n### \ud83d\udcdd **Core Presentation Tools**\n- `create_presentation`: Create new lightweight presentations  \n- `add_slide`: Add slides with layouts\n- `add_text`: Insert text content with positioning\n- `save_presentation`: Save as lightweight JSON format\n\n### \ud83c\udfa8 **Visual Content (ASCII-Based)**\n- `add_infographic`: Create ASCII infographics (process, comparison, timeline, hierarchy)\n- `create_chart_llm`: Generate bar, line, pie, scatter charts as ASCII art\n- `export_to_html`: Export as HTML slideshow with themes\n- `export_to_markdown`: Export as Markdown for documentation\n\n### \ud83d\udcca **Export & Management**\n- `list_presentations`: View all active presentations\n- `export_to_html`: Generate themed HTML slideshows\n- `export_to_markdown`: Create Markdown documentation\n\n## Overview\n\nThis MCP server is designed for **speed, efficiency, and AI-first content creation**. Instead of relying on heavy dependencies like python-pptx or matplotlib, it uses:\n\n- \ud83e\udd16 **LLM Integration**: Generate complete presentations from prompts\n- \ud83e\udeb6 **Zero Heavy Dependencies**: Pure Python with minimal requirements  \n- \u26a1 **Lightning Fast**: Startup in milliseconds, not seconds\n- \ud83d\udcca **ASCII Visualizations**: Charts and infographics without plotting libraries\n- \ufffd **Lightweight Storage**: JSON-based data structures\n- \ud83c\udf10 **Multiple Exports**: Markdown, HTML, and structured JSON\n\n## \u2728 Key Features\n\n### \ud83e\udeb6 **Ultra-Lightweight Architecture**\n- **Zero heavyweight dependencies** - No python-pptx, matplotlib, or PIL\n- **Fast startup** - Loads in milliseconds \n- **Minimal memory footprint** - Uses <50MB RAM\n- **JSON-based storage** - Lightweight data structures\n\n### \ud83e\udd16 **LLM-Powered Content Generation**\n- **Complete presentation generation** from single prompts\n- **Intelligent content creation** - titles, bullets, summaries\n- **ASCII-based charts and infographics** - no heavy plotting libraries\n- **Template-based enhanced output** with emojis and structure\n\n### \ud83d\udcca **Rich Media Support (Lightweight)**\n- **ASCII art charts** - bar, line, pie, scatter\n- **ASCII infographics** - process flows, comparisons, timelines, hierarchies  \n- **Multiple export formats** - JSON, Markdown, HTML\n- **Themed outputs** - default, dark, minimal, corporate\n\n### \u26a1 **Performance Benefits**\n- **Instant startup** vs 2-3 seconds for heavy alternatives\n- **10x smaller memory usage** compared to traditional solutions\n- **No binary dependencies** - pure Python implementation\n- **Cross-platform compatibility** without external tools\n\n## Quick Start\n\n### Installation\n\n1. Clone or download this repository\n2. Install dependencies:\n   ```bash\n   uv sync --dev --all-extras\n   ```\n\n### Usage\n\n#### Claude Desktop Configuration\n\nAdd to your Claude Desktop configuration file:\n\n**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"slidecraft-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"/path/to/slidecraft-mcp\",\n        \"run\",\n        \"slidecraft-mcp\"\n      ]\n    }\n  }\n}\n```\n\n#### Direct Usage\n\n```bash\n# Run the server\nuv run slidecraft-mcp\n\n# For development\nuv sync --dev\nuv run slidecraft-mcp\n```\n\n## \ud83d\ude80 Quick Usage Examples\n\n### Generate Complete Presentation from Prompt\n```bash\n# Create entire presentation with LLM\ncreate_presentation_from_prompt({\n  \"prompt\": \"Benefits of microservices architecture\",\n  \"slide_count\": 5,\n  \"template\": \"business\"\n})\n```\n\n### Add ASCII Infographic\n```bash\n# Add process flow infographic\nadd_infographic({\n  \"presentation_id\": \"abc123\",\n  \"slide_index\": 0,\n  \"infographic_type\": \"process\",\n  \"data\": \"Development pipeline: Code \u2192 Build \u2192 Test \u2192 Deploy\"\n})\n```\n\n### Export to Multiple Formats\n```bash\n# Export as HTML slideshow\nexport_to_html({\n  \"presentation_id\": \"abc123\",\n  \"filename\": \"my_presentation.html\",\n  \"theme\": \"corporate\"\n})\n\n# Export as Markdown documentation  \nexport_to_markdown({\n  \"presentation_id\": \"abc123\",\n  \"filename\": \"presentation.md\"\n})\n```",
    "bugtrack_url": null,
    "license": null,
    "summary": "SlideCraft MCP - Lightweight presentation generator with LLM-powered content creation",
    "version": "0.1.0",
    "project_urls": {
        "Documentation": "https://github.com/slidecraft-mcp/slidecraft-mcp#readme",
        "Homepage": "https://github.com/slidecraft-mcp/slidecraft-mcp",
        "Issues": "https://github.com/slidecraft-mcp/slidecraft-mcp/issues",
        "Repository": "https://github.com/slidecraft-mcp/slidecraft-mcp"
    },
    "split_keywords": [
        "ascii",
        " lightweight",
        " llm",
        " mcp",
        " powerpoint",
        " presentations"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "458caa6a4da8bb44632e173e6c037f474b98574f14a57ef3918b1844dcc23c57",
                "md5": "11c5be9ade71c2b5aa61dea71186b039",
                "sha256": "84387d7efc6a06b1cbf1c17e029d330c2bfad2d0a0fdd52af2216bf972fbacda"
            },
            "downloads": -1,
            "filename": "slidecraft_mcp-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "11c5be9ade71c2b5aa61dea71186b039",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13",
            "size": 14000,
            "upload_time": "2025-08-15T09:54:03",
            "upload_time_iso_8601": "2025-08-15T09:54:03.254401Z",
            "url": "https://files.pythonhosted.org/packages/45/8c/aa6a4da8bb44632e173e6c037f474b98574f14a57ef3918b1844dcc23c57/slidecraft_mcp-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a140df498b6a53f48d2d28c2a453d6e203c1256044de730d06ef6a854a53ae6a",
                "md5": "17e3778b93e789855176e10ac4a1c3e4",
                "sha256": "fe9f7e9610353d393cb79f115dfbeaabb4700ac56103ed7d0e38e07511d29396"
            },
            "downloads": -1,
            "filename": "slidecraft_mcp-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "17e3778b93e789855176e10ac4a1c3e4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.13",
            "size": 39607,
            "upload_time": "2025-08-15T09:54:04",
            "upload_time_iso_8601": "2025-08-15T09:54:04.995633Z",
            "url": "https://files.pythonhosted.org/packages/a1/40/df498b6a53f48d2d28c2a453d6e203c1256044de730d06ef6a854a53ae6a/slidecraft_mcp-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-15 09:54:04",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "slidecraft-mcp",
    "github_project": "slidecraft-mcp#readme",
    "github_not_found": true,
    "lcname": "slidecraft-mcp"
}