fcp-slides
MCP server for semantic presentation operations.
What It Does
fcp-slides lets LLMs create and edit PowerPoint presentations by describing slide intent -- layouts, shapes, tables, charts, text styling -- and renders it into standard .pptx files. Instead of writing python-pptx code, the LLM works with operations like slide add layout:title, placeholder set title "Q4 Report", and table add 5 4 label:metrics. Built on the FCP framework, powered by python-pptx for serialization.
Quick Example
slides_session('new "Q4 Review"')
slides([
'slide add layout:title',
'placeholder set title "Q4 Business Review"',
'placeholder set subtitle "Prepared by Finance Team"',
'slide add layout:blank',
'table add 5 4 label:metrics x:1in y:1.5in w:8in h:4in',
'table header metrics "Region" "Revenue" "Costs" "Margin"',
'table set metrics 2 1 "North"',
'table set metrics 2 2 "$1.25M"',
'chart add bar label:revenue title:"Revenue by Region" x:1in y:1.5in w:8in h:4.5in',
'notes set "Discuss regional performance trends"',
])
slides_session('save as:./q4_review.pptx')
Available MCP Tools
| Tool | Purpose |
|---|
slides(ops) | Batch mutations -- slides, shapes, text, tables, charts, images, styling |
slides_query(q) | Inspect the presentation -- slides, shapes, placeholders, layout info |
slides_session(action) | Lifecycle -- new, open, save, checkpoint, undo, redo |
slides_help() | Full reference card |
Installation
Requires Python >= 3.11.
pip install fcp-slides
MCP Client Configuration
{
"mcpServers": {
"slides": {
"command": "uv",
"args": ["run", "python", "-m", "fcp_slides"]
}
}
}
Architecture
3-layer architecture:
MCP Server (Intent Layer)
Parses op strings, dispatches to verb handlers
|
Semantic Model
Thin wrapper around python-pptx Presentation
Slide/shape index, shape refs, undo/redo via byte snapshots
|
Serialization (python-pptx)
Semantic model -> .pptx binary output
Key features:
- Slide layouts -- Title, blank, content, section header, and custom layouts
- Shapes -- Rectangles, ellipses, arrows, textboxes, connectors
- Tables -- Create, populate, style with headers and merged cells
- Charts -- Bar, line, pie, scatter, area, doughnut, and more
- Images -- Add from file or set as slide background
- Text styling -- Font, size, color, bold, italic, alignment, spacing
- Layout ops -- Align, distribute, z-order for shape arrangement
- Undo/redo -- Full presentation snapshots with event sourcing
- Keynote-compatible -- Standard PPTX output opens in Keynote, Google Slides, LibreOffice
Development
uv sync
uv run pytest # 70 tests
uv run ruff check # linting
uv run pyright # type checking
License
MIT
