mkslides-mcp-server

What is mkslides-mcp-server?

mkslides-mcp-server is an MCP (Model Context Protocol) server that generates HTML slides from Markdown content using the mkslides library. It integrates with MCP clients like Claude in VSCode, enabling users to create and manage presentations directly from an AI chat interface.

How to use mkslides-mcp-server?

Install the server via pip (using uv sync or pip install .) or build the Docker image. Then configure it in your MCP client settings (e.g., Claude in VSCode) to run the server process or Docker container. Once configured, invoke the generate_slides tool with your Markdown content, optionally specifying a slide theme, highlight theme, or Reveal.js options.

Key features of mkslides-mcp-server

• Generate HTML slides from Markdown content.
• Support for mkslides configuration options (themes, highlight themes, Reveal.js options).
• Clean handling of temporary files.
• Containerized deployment option using Docker.

Use cases of mkslides-mcp-server

• Create presentation slides by writing Markdown in an AI chat interface like Claude in VSCode.
• Quickly generate slide decks without leaving the editor or learning slide-specific tools.
• Automate slide generation as part of a documentation or reporting pipeline.

FAQ from mkslides-mcp-server

What prerequisites are needed?

You need Python 3.12 or higher, the mkslides CLI installed and available in your PATH, and an MCP client (e.g., Claude in VSCode). Docker is also required if using the Docker installation method.

How do I configure the server in my MCP settings?

Add an entry to your MCP settings JSON. For a pip installation, use the command python with the path src/mkslides_mcp_server/server.py. For Docker, use the command docker with arguments to run the image, including a volume mount for the output directory.

Where are the generated slides saved?

By default, slides are saved to the ./mkslides_output directory on the host. When using Docker, the container saves files to /app/mkslides_output, which must be mapped to a host directory via the -v volume mount.

What parameters does the generate_slides tool accept?

The only required parameter is markdown_content (a string). Optional parameters include slides_theme, slides_highlight_theme, and revealjs_options (a dictionary of Reveal.js settings).

Can I customize the slide theme and transition?

Yes. You can set slide themes via the slides_theme parameter, highlight themes via slides_highlight_theme, and override Reveal.js options like transition using the revealjs_options dictionary.