Servidor MCP (Protocolo de Contexto de Modelo) para PowerPoint

Un servidor MCP (Protocolo de Contexto de Modelo) basado en Python que proporciona herramientas para crear, inspeccionar y editar presentaciones de PowerPoint utilizando fastmcp y python-pptx.

Requisitos previos

• Sistema operativo Windows

• Python 3.12 (ya instalado en C:\Users\Lumbini_User\AppData\Local\Programs\Python\Python312)

• Entorno virtual local .venv con las dependencias instaladas.

Related MCP server: PPTX MCP Server

Herramientas expuestas

El servidor registra y ejecuta las siguientes herramientas:

1. create_presentation(path: str): Crea una nueva presentación de PowerPoint en blanco en la ruta especificada.

2. add_slide(path: str, layout_idx: int = 6): Agrega una nueva diapositiva a la presentación en path utilizando índices de plantilla de diseño (por ejemplo, 6 para diapositiva en blanco).

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): Agrega un cuadro de texto con texto formateado personalizado.

4. add_bullet_points(path, slide_idx, points, left_in, top_in, width_in, height_in, font_name, font_size_pt, color_hex): Agrega una lista formateada de viñetas.

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): Inserta formas geométricas como rectángulos, elipses, triángulos, etc.

6. add_picture(path, slide_idx, image_path, left_in, top_in, width_in, height_in): Inserta una imagen local.

7. add_table(path, slide_idx, rows, cols, left_in, top_in, width_in, height_in, data): Inserta y completa tablas.

8. get_presentation_info(path): Devuelve estructuras detalladas, ubicaciones de formas, textos y tablas de todas las diapositivas.

9. search_replace_text(path, search_str, replace_str): Realiza una búsqueda y reemplazo en toda la presentación en cuadros de texto, formas y tablas.

10. delete_slide(path, slide_idx): Elimina la diapositiva en el índice especificado.

Configuración del cliente MCP

Para registrar este servidor con un host MCP (como Claude Desktop o cursor), agregue la siguiente entrada a su archivo de configuración del host:

{
  "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": {}
    }
  }
}

Desarrollo y pruebas locales

1. Active el entorno virtual:

   .venv\Scripts\Activate.ps1

2. Ejecute el servidor directamente:

   python ppt_mcp_server.py