powerpoint-mcp-live

Редактируйте презентацию PowerPoint, пока она открыта — ИИ подключается к уже существующему окну, а не запускает собственное.

Live editing · Windows (COM) · 23 tools

Большинство MCP-серверов PowerPoint (включая mcp-server-powerpoint из этого рабочего пространства) работают, запуская новый невидимый процесс PowerPoint, открывая в нём ваш файл и закрывая его по завершении. Это отлично подходит для скриптовой генерации презентаций, но означает, что ИИ никогда не видит то же окно, что и вы.

powerpoint-mcp-live делает наоборот: он подключается через COM к любому уже открытому окну PowerPoint, используя тот же подход «поиск запущенного приложения», что и word-mcp-live и excel-mcp-live. Он никогда не запускает PowerPoint и не закрывает его — он работает только с презентациями, которые вы открыли сами.

Требования

• Windows (COM-автоматизация доступна только в Windows — для этого проекта нет режима macOS/Linux)

• Microsoft PowerPoint установлен и уже запущен с открытой презентацией

• Python 3.11+

Related MCP server: mcp-powerpoint

Установка

git clone <this-repo-url>
cd powerpoint-mcp-live
pip install -e .

Или запустите прямо из исходников с помощью uv — шаг установки не нужен:

uv run powerpoint_mcp_server.py

Настройка клиента (.mcp.json)

Укажите вашему MCP-клиенту на каталог проекта. Для Claude Code добавьте это в .mcp.json в вашем проекте (или в ~/.claude.json для конфигурации на уровне пользователя):

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "uv",
      "args": [
        "--directory",
        "G:/Ai/MCP/powerpoint-mcp-live",
        "run",
        "powerpoint_mcp_server.py"
      ],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

Если вместо этого вы установили его с помощью pip install -e ., вы можете использовать консольный скрипт напрямую:

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "powerpoint-mcp-live",
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

MCP_AUTHOR / MCP_AUTHOR_INITIALS задают имя/инициалы автора, прикрепляемые к новым комментариям к слайдам (по умолчанию: "Author" / "").

Поддерживаемые функции

Каждый инструмент работает с презентацией, которая уже открыта в PowerPoint. presentation почти везде необязателен — опустите его, чтобы работать с активной презентацией.

Пока не поддерживаются: таблицы, диаграммы, SmartArt, анимации, переходы, шаблоны/темы — для этого используйте mcp-server-powerpoint, который запускает собственный экземпляр PowerPoint и имеет гораздо более широкий охват операций.

Примеры запросов

"I have this deck open — read the text on slide 3 and tell me if the bullets are too long."
"Add a new slide after slide 2 with a blank layout."
"Add a text box on slide 4 that says 'Draft — do not distribute' in red."
"Make the title on slide 1 bold and increase it to 44pt."
"Export slide 5 as an image so I can check whether anything overlaps."
"Add a comment on slide 3 asking if the chart numbers are up to date."

Известные ограничения

• Только Windows. COM-автоматизации PowerPoint не существует на macOS/Linux.

• Презентация должна быть уже открыта в PowerPoint. Этот сервер не создаёт и не открывает файлы — для этого обратитесь к mcp-server-powerpoint.

• Нет группировки для единичной отмены. COM API Word может объединять несколько правок в одно Ctrl+Z; PowerPoint — нет (как и Excel). Вызов инструмента, выполняющий несколько записей, может потребовать нескольких нажатий Ctrl+Z для полной отмены.

• Комментарии требуют PowerPoint 2016+ (современные ветвящиеся комментарии).

Разработка

См. CLAUDE.md с заметками об архитектуре и проектными ограничениями — в частности, почему этот сервер никогда не должен запускать или завершать PowerPoint самостоятельно.