PPTX MCP Server

Сервер PPTX MCP

Сервер на базе FastMCP для программного создания, редактирования и рендеринга презентаций PowerPoint (PPTX). Поддерживает создание слайдов, вставку текста и фигур, внедрение изображений и рендеринг слайдов в PNG (с LibreOffice).

Функции

• Создание/очистка презентаций: создание новых или сброс существующих файлов PPTX.
• Добавить слайды: вставляйте слайды с настраиваемыми макетами.
• Текст и содержимое: добавляйте на слайды заголовки, содержимое и пользовательские текстовые поля.
• Фигуры: вставляйте разнообразные фигуры PowerPoint (включая элементы блок-схем).
• Изображения: встраивайте изображения в слайды.
• Описание слайда: Получите текстовое резюме содержимого слайда для проверки.
• Рендеринг слайдов: рендеринг слайдов в виде изображений PNG (требуется LibreOffice).
• Загрузить PPTX: загрузить созданный файл презентации.

Требования

• Питон 3.12+
• python-pptx
• Подушка
• FastMCP
• LibreOffice (для рендеринга слайдов; должен быть установлен отдельно и доступен в системной переменной PATH)

Установка

1. Установите зависимости Python:
   pip install -r requirements.txt
   (Или см. pyproject.toml для зависимостей)
2. Установите LibreOffice (для рендеринга изображений):
   • Linux: sudo pacman -S libreoffice-fresh или sudo apt install libreoffice
   • macOS: brew install --cask libreoffice
   • Windows: Загрузить с libreoffice.org

Использование

Запустите сервер:

Вы можете задать хост и порт сервера с помощью переменных среды:

• HOST (по умолчанию: 127.0.0.1 )
• PORT (по умолчанию: 8000 )

Например, для запуска на всех интерфейсах и порту 9000:

Или (для разработки с помощью FastMCP):

Обзор API

Сервер предоставляет инструменты и ресурсы через FastMCP, включая:

• create_or_clear_presentation(filename)
• add_slide(filename, layout_index)
• add_title_and_content(filename, slide_index, title, content)
• add_textbox(filename, slide_index, text, left_inches, top_inches, width_inches, height_inches, font_size_pt, bold)
• add_shape(filename, slide_index, shape_type_name, left_inches, top_inches, width_inches, height_inches, text)
• add_picture(filename, slide_index, image, left_inches, top_inches, width_inches, height_inches)
• get_slide_content_description(filename, slide_index)
• get_slide_image(filename, slide_index)(требуется LibreOffice)
• get_pptx_file(filename)

Полную информацию о параметрах и доступных типах фигур смотрите в коде.

Презентации и шаблоны

• Презентации сохраняются в каталоге presentations/ .
• Вы можете добавить свои собственные шаблоны в presentations/templates/ .

Лицензия

Подробности см. в разделе ЛИЦЕНЗИЯ .