mdslides-mcp-server

by bsmnyk

6 stars

181 downloads

Not rated

GitHub

Other

About

MCP (Model Context Protocol) server for generating HTML slides from Markdown content

Details

Author: bsmnyk
GitHub stars: 6
Downloads: 181
Categories: Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mdslides-mcp-server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

From the repository

Install via pip (uv sync or pip install .) or use the provided Docker deployment script. Configure the server in your MCP client settings (e.g., Claude in VSCode) by specifying the command and arguments for either a local Python run or a Docker attach. Once configured, invoke the generate_slides tool with Markdown content and optional theme/options parameters to generate and serve slides via a local HTTP server.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mdslides-mcp-server": {
            "mdslides-mcp-server": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "mdslides-mcp-server": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

mdslides-mcp-server

An MCP (Model Context Protocol) server for generating HTML slides from Markdown content using the mkslides library.

What it Does

This server provides a simple interface to the mkslides command-line tool, allowing you to generate presentation slides directly from Markdown input via the Model Context Protocol. This enables integration with tools like Claude in VSCode to easily create and manage presentations.

Demo

mcp-demo.webm

Features

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

Installation

Prerequisites

Python 3.12 or higher
mkslides installed and available in your PATH.
Model Context Protocol (MCP) client (e.g., Claude in VSCode).
Docker (if using the Docker installation method).

Installation Methods

Using pip

1. Clone the repository:

    git clone https://github.com/your-repo/mdslides-mcp-server.git

    cd mdslides-mcp-server

2. Install using pip and uv (recommended):

    uv sync

Or using pip:

    pip install .

Using Docker

1. Ensure Docker is installed and running.
2. From the repository root, run the deployment script:

./deploy_mdslides_docker.sh

This script will build the Docker image (if not already built) and start a container instance named mdslides-mcp-instance. The server inside the container will be running and ready to accept connections via MCP. The script also handles creating the necessary output directory (./mkslides_output) on the host.

Configuration in MCP Settings

To use the server with your MCP client (like Claude in VSCode), you need to add it to your MCP settings.

If you installed using pip, you can run the server directly:

{
  "mcpServers": {
    "mdslides-mcp-local": {
      "command": "python",
      "args": ["src/mdslides_mcp_server/server.py"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

If you are using the Docker deployment via the script:

Configure your MCP client to attach to the running container instance:

{
  "mcpServers": {
    "mdslides-mcp-local": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "command": "docker",
      "args": [
        "attach",
        "mdslides-mcp-instance"
      ],
      "transportType": "stdio"
    }
  }
}

Usage with Claude/VSCode

Once configured in your MCP settings, you can use the generate_slides tool directly within your Claude chat interface in VSCode.

Available Tool: `generate_slides`

Generates HTML presentation slides from Markdown input using mkslides and serves them via a local HTTP server.

Parameters:

markdown_content (string, required): Raw Markdown text for the slides.
slides_theme (string, optional): Theme name for the slides (e.g., black, white, league, beige, night, serif, simple, solarized, moon, dracula, sky, blood). Overrides the default.
slides_highlight_theme (string, optional): Syntax highlighting theme for code blocks (any built-in theme from highlight.js).
revealjs_options (object, optional): A dictionary containing Reveal.js config options to merge/override defaults.

Returns:

(string): A URL (e.g., http://localhost:8080/latest/index.html) pointing to the generated HTML slides served by the MCP server's internal HTTP server. You can open this URL in your browser.

Example Usage:

<use_mcp_tool> <server_name>mdslides-mcp-local</server_name> <tool_name>generate_slides</tool_name> <arguments> { "markdown_content": "# My Presentation\n\n---\n\n## Slide 2\n\n- Bullet 1\n- Bullet 2", "slides_theme": "black", "revealjs_options": { "transition": "slide" } } </arguments> </use_mcp_tool>

This will generate the slides in the default output directory (./mkslides_output) using the 'black' theme and a 'slide' transition.

Development

Contributing

Contributions are welcome! Please follow standard GitHub practices: fork the repository, create a feature branch, and submit a pull request.

Running Tests

Currently, there is a placeholder test file (tests/test_server.py). To run tests, you would typically use a test runner like pytest:

pytest
Remember to add actual tests to tests/test_server.py.
Building from Source

Follow the pip installation steps above to set up your development environment.

License

This project is licensed under the MIT License - see the LICENSE file for details. (Note: A LICENSE file does not currently exist in the repository. You may want to create one.)

Acknowledgements

mkslides for the core slide generation functionality.

Model Context Protocol for enabling server integration.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

mdslides-mcp-server

What it Does

Demo

Features

Installation

Prerequisites

Installation Methods

Using pip

Using Docker

Configuration in MCP Settings

Usage with Claude/VSCode

Available Tool: generate_slides

Development

Contributing

Running Tests

Building from Source

License

Acknowledgements

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

Available Tool: `generate_slides`