pptx-mcp 0.1.0__tar.gz

pptx_mcp-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(/Users/swak/Documents/GitHub/pptx-mcp/.venv/bin/python:*)",
+      "Bash(.venv/bin/python -m pytest:*)"
+    ]
+  }
+}

pptx_mcp-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+.eggs/
+*.pptx
+!examples/*.pptx
+.env
+.venv/
+venv/
+ENV/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+*.log
+.DS_Store
+Thumbs.db
+output/
+*.bak

pptx_mcp-0.1.0/CLAUDE.md

@@ -0,0 +1,52 @@
+# PPTX MCP — Claude Code Instructions
+
+## Running the Server
+
+- Use `.venv/bin/python` — system Python does not have dependencies installed
+- Start: `.venv/bin/python -m pptx_mcp.server`
+- CLI: `.venv/bin/python -m pptx_mcp serve`
+- Tests: `.venv/bin/python -m pytest tests/ -q`
+
+## Tool Usage Patterns
+
+### Quick generation (single step)
+Use `generate_presentation` — plans, optimizes, and renders in one call.
+
+### Controlled workflow (multi-step)
+1. `plan_presentation` — get a PresentationDefinition
+2. `optimize_design` — improve layout
+3. `create_presentation` — render to .pptx
+
+### Editing existing decks
+1. `read_presentation` — parse .pptx to JSON
+2. `add_slide` / `update_slide` / `delete_slide` / `move_slide` / `duplicate_slide`
+3. `review_presentation` — get design feedback
+4. `improve_presentation` — auto-fix issues
+
+### Discovery tools
+- `get_slide_templates` — all 23 slide types with examples
+- `get_brand_presets` — available brand configurations
+- `get_deck_types` — deck archetypes (pitch, board, sales, all-hands)
+
+## Important Constraints
+
+- `output_path` must end in `.pptx`
+- `slide_index` is 0-based
+- `plan_presentation` returns JSON, not a file
+- Brand presets: executive, technical, minimal, creative, corporate
+- All file paths should be absolute
+- Hyperlinks only support http://, https://, mailto: schemes
+
+## Project Architecture
+
+```
+pptx_mcp/
+  server.py     — 16 MCP tools, 7 prompts, 2 resources
+  cli.py        — CLI: serve, generate, read, review, plan, improve
+  models/       — Pydantic models (slides, brand, review)
+  engine/       — Generator, parser, layouts, charts, shapes
+  brand/        — Brand config loading + 5 presets
+  agents/       — Planner, designer, reviewer, iterator
+  review/       — Review engine + design rules
+  utils/        — Errors, logging, path validation
+```

pptx_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 swak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.