jh-presentation MCP server

jh-presentation

Let AI build your presentations as real web pages. jh-presentation is an MCP server plus a small, dependency-free slide engine. Your AI client (Claude Desktop, Claude Code, VS Code, …) writes the content; jh-presentation turns it into a single self-contained HTML file with live diagrams, step-by-step animation, in-place editing and PDF export — and lets the AI check its own work with layout audits and screenshots.

No API key is needed: the thinking is done by the AI client you already use.

日本語の説明はこちら

Why HTML instead of PowerPoint?

AI models are far better at writing HTML/CSS/JS than at driving PPTX. That makes things possible that slide tools struggle with:

• Diagrams that build up step by step, with data flowing along the arrows
• A system overview you can click to zoom into, revealing the parts inside
• ER diagrams and sequence diagrams generated from data
• Charts that animate, code that highlights line by line, demos that actually run
• Everything in one HTML file that works offline — mail it, put it on a share, present from a browser

Features

• Single-file decks — engine, theme, brand and images are embedded. No build step, no CDN, works from file://
• Diagram components (data in, motion out) — flow diagrams / zoom maps, ER diagrams, sequence diagrams, charts (bar, line, pie, donut), 3D layer stacks, before/after sliders, terminal replays. The AI writes JSON; layout, animation, clicks and the static PDF view are handled for you
• Steps — arrow keys reveal content one step at a time; components hook into the same steps
• Themes — five built-in themes (default, dark, corporate, pop, mono), a live theme gallery, and AI-generated custom themes
• Branding — your name, logo and a label (e.g. DRAFT) in a header/footer band
• Self-checking AI — auditdeck detects overflow, clipping, overlapping text, low contrast, missing images and external requests; screenshotdeck returns slide images so the AI can look and fix
• Edit without AI — double-click any text box to edit it in place, press Ctrl+S to save straight back to the file (only the edited text is replaced)
• Presenting — presenter view with notes, next slide and timer; overview; blackout; fullscreen window
• Safe saving — atomic writes, revision checks against concurrent edits, 20-version history with restore
• Request templates — tech talk, lightning talk, progress report, tech proposal (as MCP prompts)

Requirements

• Node.js 20 or later
• Google Chrome or Microsoft Edge (used for audits, screenshots and PDF export; set CHROME_PATH if it is installed somewhere unusual)

Quick start

Claude Desktop

Open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "jh-presentation": {
      "command": "npx",
      "args": ["-y", "jh-presentation"],
      "env": { "JH_PRESENTATION_HOME": "C:/Users/you/Documents/decks" }
    }
  }
}

Quit Claude Desktop from the tray icon and start it again. Then ask, for example:

Make a 15-minute deck explaining Git branching strategies, with diagrams and step-by-step reveals.

Claude Code

Shortened. The full README is on GitHub.