mdslides-mcp-server

一个用于从Markdown内容生成HTML幻灯片的MCP（模型上下文协议）服务器，使用mkslides库。

功能说明

此服务器为mkslides命令行工具提供了一个简单的接口，允许直接从Markdown输入通过模型上下文协议生成演示文稿。这使得与诸如Claude在VSCode中的集成变得容易，从而轻松创建和管理演示文稿。

演示

mcp-demo.webm

特性

• 从Markdown生成HTML幻灯片。
• 支持多种mkslides配置选项（主题、语法高亮主题、Reveal.js选项）。
• 清晰处理临时文件。
• 使用Docker的容器化部署选项。

安装要求

先决条件

• Python 3.12或更高版本
• mkslides已安装并添加到系统PATH中
• 模型上下文协议（MCP）客户端（例如，Claude在VSCode）
• Docker（如果使用Docker安装方法）

安装方式

使用pip

1. 克隆仓库：

git clone https://github.com/your-repo/mdslides-mcp-server.git # 请替换为实际仓库URL cd mdslides-mcp-server

2. 使用pip和uv（推荐）安装：
    ```bash
uv sync && uv run

使用Docker

1. 构建镜像：

docker build -t mdslides .

2. 运行容器：
    ```bash
docker run --rm -it -v $(pwd):/app mdslides

配置说明

服务器配置示例

# config.py
class MCPConfig:
    def __init__(self):
        self.server_port = 8000  # 设置服务器端口
        self.output_dir = "mkslides_output"  # 设置输出目录
        self.default_theme = "white"  # 默认主题设置

使用说明

在Claude/VSCode中的使用示例

<!-- use_mcp_tool.xml -->
<use_mcp_tool>
    <tool_name>generate_slides</tool_name>
    <parameters>
        <markdown_content>## 标题\n- 列点1\n- 列点2</markdown_content>
        <slides_theme>black</slides_theme>
        <revealjs_options>
            <transition>slide</transition>
        </revealjs_options>
    </parameters>
</use_mcp_tool>

这将使用“黑色”主题和“幻灯片”过渡效果生成演示文稿，输出到默认目录./mkslides_output。

开发信息

贡献指南

欢迎贡献！请按照常规GitHub流程： fork仓库，创建功能分支，并提交pull request。

测试方法

目前有一个占位符测试文件（tests/test_server.py）。使用测试运行器如pytest执行测试：

pytest

记得向tests/test_server.py添加实际的测试用例。

从源码构建

按照pip安装步骤设置开发环境。

许可证

本项目 licensed under the MIT License - 请查看LICENSE文件获取详细信息。（注意：当前仓库中没有LICENSE文件，建议创建一个。）

致谢

• mkslides感谢核心幻灯片生成功能。
• 模型上下文协议感谢服务器集成的支持。