Mkslides MCP Server

The mdslides‑mcp-server solves a common pain point for developers and technical writers: turning Markdown notes into polished HTML slide decks without leaving their coding environment. By exposing the command‑line tool through the Model Context Protocol, it lets AI assistants such as Claude in VS Code generate and preview presentations on demand. Instead of manually running a separate script, the assistant can request slide creation as part of its workflow, streamlining content production and iteration.

At its core, the server listens for an MCP request named . When invoked, it receives raw Markdown text and optional styling parameters—slide theme, syntax‑highlighting theme, or custom Reveal.js options. The server then writes the Markdown to a temporary file, calls with the supplied configuration, and serves the resulting HTML via an internal HTTP server. The response is a simple URL that the AI can return to the user, allowing instant preview in any browser. This tight integration keeps the presentation pipeline fully automated while still offering full control over themes and Reveal.js behavior.

Key capabilities include:

• Theme flexibility: Choose from a wide range of built‑in themes (black, white, league, etc.) or override the default to match branding.
• Syntax highlighting: Specify any Highlight.js theme for code blocks, ensuring consistency across slides.
• Custom Reveal.js options: Pass arbitrary configuration objects to tweak navigation, transitions, or plugins without modifying the underlying tool.
• Clean temporary file handling: The server automatically cleans up intermediate files, keeping the host filesystem tidy.
• Docker deployment: A ready‑to‑run container simplifies setup on CI pipelines or remote servers, ensuring the same environment across machines.

In real‑world scenarios, teams can embed slide generation into documentation workflows—e.g., automatically producing a deck from a changelog, meeting notes, or design spec Markdown. Educators can ask an AI to transform lecture outlines into slides on the fly, while developers might generate quick demos from code‑commented Markdown. The MCP interface makes it trivial to trigger these actions from chat or code editors, turning static Markdown into dynamic presentations with a single command.