MCP Pandoc Md2pptx

🚀 mcp-pandoc-md2pptx：Markdown转PowerPoint转换器

mcp-pandoc-md2pptx是一个基于Model Context Protocol（MCP）的服务器工具，借助pandoc将Markdown内容转换为PowerPoint（PPTX）演示文稿，能很好地保留文本的格式和结构，让你轻松地将文档、笔记等各种Markdown内容转化为专业演示文稿。

🚀 快速开始

本MCP服务器提供了一个简单的工具，可将Markdown内容转换为PowerPoint演示文稿，同时保留格式和结构。非常适合从文档、笔记或任何Markdown内容创建演示文稿。

✨ 主要特性

• 提供了convert-contents工具，可将Markdown内容转换为PowerPoint（PPTX）格式。
• 支持多种输入方式，既可以直接输入Markdown内容，也可以指定Markdown输入文件路径。
• 可指定输出的PPTX文件的完整路径。
• 支持使用自定义的PPTX模板进行样式设置。

📦 安装指南

前提条件

1. 安装Pandoc

   # macOS
   brew install pandoc
   
   # Ubuntu/Debian
   sudo apt-get install pandoc
   
   # Windows
   # 从以下链接下载: https://pandoc.org/installing.html
   

2. 安装UV包

   # macOS
   brew install uv
   
   # Windows/Linux
   pip install uv
   

安装方式

方式一：手动配置

将以下配置添加到Claude桌面配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-pandoc-md2pptx": {
      "command": "uvx",
      "args": ["mcp-pandoc-md2pptx"]
    }
  }
}

方式二：使用Smithery自动安装

npx -y @smithery/cli install mcp-pandoc-md2pptx --client claude

💻 使用示例

基础用法

"将此Markdown转换为PowerPoint并保存为 /presentations/demo.pptx:
# 我的演示文稿
## 幻灯片1
这里是内容"

文件转换

"将 /path/to/input.md 转换为PPTX并保存为 /path/to/output.pptx"

使用自定义模板

"使用 /templates/theme.pptx 作为模板将Markdown转换为PPTX并保存为 /presentations/styled.pptx"

📚 详细文档

工具说明

1. convert-contents
   • 功能：将Markdown内容转换为PowerPoint（PPTX）格式。
   • 输入参数：
     • contents（字符串）：要转换的Markdown内容（如果未提供input_file，则此参数为必需）。
     • input_file（字符串）：Markdown输入文件的路径（如果未提供contents，则此参数为必需）。
     • output_file（字符串）：PPTX输出文件的完整路径（必需）。
     • template（字符串）：用于样式设置的模板PPTX文档的路径（可选）。

模板支持

可以创建自定义的PowerPoint模板以实现一致的品牌风格：

1. 生成默认模板：

   pandoc -o template.pptx --print-default-data-file reference.pptx
   

2. 在PowerPoint中使用你选择的字体、颜色和幻灯片布局进行自定义。
3. 在转换时使用自定义模板：

   "使用 /path/to/template.pptx 作为模板转换内容"
   

🔧 技术细节

配置文件示例：

{
  "mcpServers": {
    "mcp-pandoc-md2pptx": {
      "command": "uvx",
      "args": ["mcp-pandoc-md2pptx"]
    }
  }
}

开发相关

测试

uv run pytest

构建

uv sync
uv build

发布

uv publish

🤝 贡献说明

1. 报告问题：GitHub Issues
2. 提交拉取请求：改进代码库或添加新功能

🙏 致谢

特别感谢 MCP Pandoc 和 pandoc-ext/diagram

通过MCP实现简单、专注的Markdown到PowerPoint转换