JinDaGe - mcp-pandoc-md2pptx MCP Details

article

README

🚀 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模板进行样式设置。

📦 安装指南

前提条件

安装Pandoc

# macOS
brew install pandoc

# Ubuntu/Debian
sudo apt-get install pandoc

# Windows
# 从以下链接下载: https://pandoc.org/installing.html

安装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"

📚 详细文档

工具说明

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

模板支持

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

生成默认模板：

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

在PowerPoint中使用你选择的字体、颜色和幻灯片布局进行自定义。

在转换时使用自定义模板：

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

🔧 技术细节

配置文件示例：

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

开发相关

测试

uv run pytest

构建

uv sync
uv build

发布

uv publish

🤝 贡献说明

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

🙏 致谢

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

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

mcp-pandoc-md2pptx