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轉換