ppt-mcp — PowerPoint MCP на 156 инструментов
ppt-mcp
PowerPoint MCP на 156 инструментов: агент правит живую презентацию на Windows и macOS, от слайдов и таблиц до диаграмм, SmartArt и иконок Material Symbols
- 104 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент создает, редактирует, сохраняет и закрывает презентации в запущенном PowerPoint, а также может загружать картинки по URL
- Сервер видит содержимое всех открытых презентаций, поэтому файл стоит закреплять через ppt_activate_presentation
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ppt-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент создает, редактирует, сохраняет и закрывает презентации в запущенном PowerPoint, а также может загружать картинки по URL
- Сервер видит содержимое всех открытых презентаций, поэтому файл стоит закреплять через ppt_activate_presentation
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ppt-mcp подключает агента к запущенному Microsoft PowerPoint. В Windows сервер работает через COM, в macOS через Apple Events, поэтому изменения видны на экране сразу. В отличие от библиотек вроде python-pptx, которые правят файл, здесь агент управляет самим приложением. Инструменты разбиты на 26 категорий: слайды, фигуры, текст, таблицы, диаграммы, анимация, темы, SmartArt, медиа, свободные контуры, разделы, комментарии и экспорт в PDF и картинки. Иконки агент ищет в наборе Google Material Symbols (больше 2500 штук) и вставляет как SVG в цветах темы презентации. Для цветов есть 17 готовых палитр и генерация набора по одному фирменному цвету. Инструмент `ppt_activate_presentation` закрепляет все вызовы за одним файлом, чтобы агент не правил соседнюю презентацию. Если несколько диалогов работают с разными файлами, в каждом вызове можно передать параметр `presentation`. Проверка типографики `ppt_check_typography` находит висячие строки и автоматически сжатый текст.
Для кого. Для тех, кто собирает презентации в PowerPoint на Windows или Mac и хочет доверить агенту в Claude Code, Cursor или Codex всю сборку слайдов, включая таблицы, диаграммы и иконки.
Подходит, если
- Нужна презентация с нуля по короткому описанию: три слайда о продукте с иконками, цветовой схемой и акцентом, как в примерах репозитория
- Фирменную палитру надо применить ко всей презентации: достаточно назвать главный цвет, и сервер сгенерирует набор цветов темы
- Требуется массовая правка: заменить шрифты, выровнять фигуры, переместить или продублировать группу слайдов
- Хочется проверить готовую презентацию на висячие строки и текст, который PowerPoint тихо уменьшил
- Работаете на Mac и нужен PowerPoint MCP, который управляет живым приложением
Не подходит, если
- PowerPoint не установлен: сервер управляет только запущенным приложением Microsoft
- На macOS нужны SmartArt, теги или установка стиля таблицы: эти 12 инструментов на Mac отказываются работать
- Нужна работа с файлом pptx на сервере без графического окружения: для этого подходят файловые библиотеки вроде python-pptx
- Нужен небольшой набор инструментов для шаблонов на Windows: PowerPoint MCP от Ayush Maniar дает 11 инструментов с упором на шаблоны
Пример запроса к агенту
Сделай презентацию из 5 слайдов для приложения заметок NoteAI: белый фон, бирюзовый акцент, слайды про проблему, решение и возможности с иконкамиMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
PPT_AUTO_DISMISS_DIALOG- При значении true сервер сам закрывает модальное окно PowerPoint клавишей Esc.
Ограничения
Нужны Windows 11 или macOS (Apple Silicon либо Intel), установленный PowerPoint и менеджер пакетов uv. В macOS при первом вызове система спросит разрешение на автоматизацию PowerPoint, и разрешение привязано к приложению, из которого запущен сервер.
На Mac 12 инструментов отказываются работать, их список приведен в файле MACOS_PORT.md. Диаграммы, свободные контуры и группировка идут через буфер обмена, он на короткое время занят. Правка существующей диаграммы или контура пересоздает фигуру, и анимации на ней теряются. Автор советует чаще сохранять файл: на Mac зафиксирован случай, когда PowerPoint закрыл все документы после системного запроса.
Если в Windows на экране висит модальное окно, вызовы повторяются до 15 секунд, затем возвращается ошибка. Файла лицензии в дереве репозитория нет, MIT указана в описании.
Как отключить. В Claude Code выполните claude mcp remove powerpoint. В других клиентах удалите блок powerpoint из файла конфигурации MCP (для Codex это ~/.codex/config.toml) и перезапустите клиент.
Частые вопросы
Как подключить PowerPoint MCP к Claude Code?
Выполните claude mcp add powerpoint uvx ppt-mcp, для общего доступа в команде добавьте флаг --scope project, и настройки попадут в файл .mcp.json. Нужен установленный PowerPoint и uv.
Есть ли PowerPoint MCP для macOS?
Да, ppt-mcp работает и в Windows, и в macOS. На Mac сервер управляет PowerPoint через Apple Events, а 12 инструментов недоступны: SmartArt, тип узла свободного контура, удаление одной анимации, теги, выбор фигур, стиль таблицы и `ppt_execute_mso`.
Чем ppt-mcp отличается от python-pptx?
python-pptx правит файл pptx без запуска приложения. ppt-mcp управляет запущенным PowerPoint, и правки появляются на экране в реальном времени. Взамен нужен установленный PowerPoint.
Как добавить иконки в презентацию через ppt-mcp?
Инструмент ppt_search_icons ищет по ключевому слову в наборе Google Material Symbols, а ppt_add_svg_icon вставляет иконку как SVG. Можно выбрать стиль (outlined, rounded, sharp), залитый вариант и цвет темы вроде accent1. На Mac иконка перед вставкой растеризуется системной утилитой sips.
Можно ли работать с несколькими презентациями одновременно?
Да. Закрепите основной файл через ppt_activate_presentation или передавайте параметр presentation в каждом вызове. Параметр принимает путь, имя файла или имя без расширения, а если файл не открыт, возвращает ошибку без подмены другим файлом.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыPowerPoint MCP Server — презентации на Windows
PowerPoint MCP Server
PowerPoint MCP для Windows: агент открывает установленный PowerPoint, заполняет шаблоны, вставляет формулы LaTeX и графики, добавляет анимацию
Скилл сборки презентаций в стиле консалтинга: агент собирает PPTX через движок на python-pptx с готовыми макетами и проверками
Скилл для сборки презентаций из HTML-слайдов с рендером, визуальной проверкой каждого слайда и конвертацией в редактируемый PPTX
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Скилл для выступлений: строит план презентации по ходу мысли слушателя, решает, где нужны картинки и видео, и проверяет готовые слайды перед сценой
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ppt-mcp — PowerPoint MCP на 156 инструментов (эта запись) | нет | не нужна | 104 | |
| PowerPoint MCP Server — презентации на Windows | нет | не нужна | 121 | сервер Ayush Maniar только для Windows, 11 инструментов, упор на шаблоны и формулы LaTeX |
| PPT Agent Skill | нет | 163 | скилл, который создает презентацию в HTML и pptx из одного предложения, без управления открытым PowerPoint |
Из блога
Коротко о README
Описание проекта называет его сервером для управления живым PowerPoint и приводит три примера запросов разной подробности вместе с готовыми слайдами: короткий, со стилем и подробный со структурой. Отдельная таблица подсказывает слова, которые улучшают результат: цветовая схема, акцент, тон, фон и выделение. Раздел о Mac перечисляет, что отличается в macOS. Каждый пример хранится в репозитории с исходным запросом, картинками слайдов и итоговым pptx.