Сервер PowerPoint Model Context Protocol (MCP)

Сервер на Python, реализующий протокол Model Context Protocol (MCP), который предоставляет инструменты для создания, просмотра и редактирования презентаций PowerPoint с использованием fastmcp и python-pptx.

Предварительные требования

• ОС Windows

• Python 3.12 (уже установлен в C:\Users\Lumbini_User\AppData\Local\Programs\Python\Python312)

• Локальное виртуальное окружение .venv с установленными зависимостями.

Related MCP server: Office-PowerPoint-MCP

Доступные инструменты

Сервер регистрирует и запускает следующие инструменты:

1. create_presentation(path: str): Создает новую пустую презентацию PowerPoint по указанному пути.

2. add_slide(path: str, layout_idx: int = 6): Добавляет новый слайд в презентацию по пути path, используя индексы шаблонов макетов (например, 6 для пустого слайда).

3. add_text(path, slide_idx, text, left_in, top_in, width_in, height_in, font_name, font_size_pt, bold, italic, color_hex, align): Добавляет текстовое поле с пользовательским форматированием текста.

4. add_bullet_points(path, slide_idx, points, left_in, top_in, width_in, height_in, font_name, font_size_pt, color_hex): Добавляет форматированный список маркированных пунктов.

5. add_shape(path, slide_idx, shape_type, left_in, top_in, width_in, height_in, fill_color_hex, line_color_hex, line_width_pt): Вставляет геометрические фигуры, такие как прямоугольники, эллипсы, треугольники и т.д.

6. add_picture(path, slide_idx, image_path, left_in, top_in, width_in, height_in): Вставляет локальное изображение.

7. add_table(path, slide_idx, rows, cols, left_in, top_in, width_in, height_in, data): Вставляет и заполняет таблицы.

8. get_presentation_info(path): Возвращает подробные структуры, расположение фигур, тексты и таблицы всех слайдов.

9. search_replace_text(path, search_str, replace_str): Выполняет поиск и замену по всей презентации в текстовых полях, фигурах и таблицах.

10. delete_slide(path, slide_idx): Удаляет слайд по указанному индексу.

Конфигурация MCP-клиента

Чтобы зарегистрировать этот сервер в MCP-хосте (например, Claude Desktop или cursor), добавьте следующую запись в файл конфигурации хоста:

{
  "mcpServers": {
    "powerpoint": {
      "command": "c:\\Users\\Lumbini_User\\Desktop\\PPT\\.venv\\Scripts\\python.exe",
      "args": [
        "c:\\Users\\Lumbini_User\\Desktop\\PPT\\ppt_mcp_server.py"
      ],
      "env": {}
    }
  }
}

Локальная разработка и тестирование

1. Активируйте виртуальное окружение:

GXP2 2. Запустите сервер напрямую:

python ppt_mcp_server.py