PPT-Agent

Crea, edita y gestiona presentaciones de PowerPoint utilizando modelos de lenguaje grandes.

Documentación

Servidor MCP de PPT-Agent

El servidor MCP de PPT-Agent proporciona la capacidad de crear, editar y gestionar presentaciones de PowerPoint mediante modelos de lenguaje grandes (LLM). Este servidor implementa la especificación del Model Context Protocol (MCP), lo que permite a los LLM interactuar con las herramientas de PPT-Agent a través de una interfaz estándar.

Resumen de funciones

El servidor MCP de PPT-Agent ofrece las siguientes funciones:

  • Crear y guardar presentaciones de PowerPoint
  • Agregar y gestionar diapositivas
  • Establecer colores de fondo y fondos SVG para las diapositivas
  • Agregar diversas formas y líneas
  • Agregar cuadros de texto y texto con formato
  • Importar imágenes SVG
  • Agregar imágenes
  • Obtener información existente de las diapositivas

Arquitectura técnica

  • Marco principal: utiliza el SDK del Model Context Protocol para implementar las funciones del servidor MCP
  • Capa de transporte: admite transporte STDIO (entrada/salida estándar), lo que facilita la integración con clientes LLM como Claude
  • Implementación de herramientas: se basa en la biblioteca Aspose.Slides para las operaciones de PowerPoint
  • Procesamiento asíncrono: utiliza Project Reactor para el manejo de respuestas asíncronas

Construcción del proyecto

Use Maven para construir el proyecto:

mvn clean package

Esto generará dos archivos JAR:

  • Archivo JAR estándar: target/pptagent-0.0.1-SNAPSHOT.jar
  • Archivo JAR ejecutable con todas las dependencias: target/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar

Ejecutar el servidor

Usar el comando Java

java -jar target/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar

Integración con Claude Desktop

Para usar este servidor MCP en Claude Desktop, debe editar el archivo de configuración de Claude Desktop y agregar PPT-Agent como servidor MCP:

  1. Encuentre el archivo de configuración de Claude Desktop:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Agregue la configuración de PPT-Agent:

{
  "mcpServers": {
    "ppt-agent": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar"
      ]
    }
  }
}
  1. Reinicie la aplicación Claude Desktop

¡Entendido! A continuación se presenta una versión complementaria que sigue el estilo de su README actual, enumerando solo los nombres de las herramientas y una descripción de una línea de su funcionalidad. Puede insertar directamente este contenido en la sección "Herramientas disponibles" para enriquecer la lista de herramientas.


Herramientas básicas

  • createPresentation - Crea una nueva presentación en blanco
  • savePresentation - Guarda la presentación en la ruta especificada

Herramientas de diapositivas

  • addSlide - Agrega una nueva diapositiva
  • selectSlide - Selecciona la diapositiva actual para operar

Herramientas de fondo

  • setBackgroundColor - Establece el color de fondo de la diapositiva
  • setBackgroundSvg - Establece el fondo SVG de la diapositiva

Herramientas de formas

  • addShape - Agrega una forma a la diapositiva
  • addLine - Agrega una línea a la diapositiva

Herramientas de gráficos

  • addColumnChart - Agrega un gráfico de barras a la diapositiva
  • addPieChart - Agrega un gráfico circular a la diapositiva
  • addLineChart - Agrega un gráfico de líneas a la diapositiva

Herramientas de animación

  • addAnimation - Agrega efectos de animación a una forma
  • addParagraphAnimation - Agrega efectos de animación a un párrafo de texto

Herramientas de imágenes/medios

  • addPictureFrameWithAspectRatio - Agrega una imagen manteniendo la proporción original
  • addPictureFrameFromBase64 - Agrega una imagen mediante datos Base64
  • addPictureFrameWithFormat - Agrega una imagen con borde y rotación
  • addPictureFrameFromBase64WithFormat - Agrega una imagen mediante datos Base64 con borde y rotación

Herramientas SVG

  • addSvgImage - Agrega una imagen SVG a la diapositiva

Herramientas de texto

  • addTextBox - Agrega un cuadro de texto a la diapositiva
  • setFormattedText - Establece el texto con formato de una forma

Herramientas de información

  • getShapesInfo - Obtiene información de todas las formas en la diapositiva
  • getSlideCount - Obtiene el número de diapositivas de la presentación

Ejemplos de uso

A continuación se presentan algunos ejemplos de uso que muestran cómo usar las herramientas de PPT-Agent a través de un LLM:

  1. Crear una nueva presentación:

    请创建一个新的演示文稿
    
  2. Agregar una diapositiva de título:

    在演示文稿中添加一个标题幻灯片,然后添加标题"PPT-Agent演示"
    
  3. Agregar una diapositiva de contenido:

    添加一个新的空白幻灯片,设置背景为浅蓝色,然后添加一个标题"主要功能"
    

Detalles técnicos

El servidor MCP de PPT-Agent utiliza las siguientes tecnologías:

  • Java 16
  • Aspose.Slides (para operaciones de PPT)
  • Model Context Protocol SDK (para la implementación de MCP)
  • Project Reactor (para el procesamiento de respuestas asíncronas)

Personalización y extensión

Para agregar nuevas herramientas, debe:

  1. Agregar nuevos métodos en las clases de herramientas existentes
  2. Crear nuevas especificaciones de herramientas en el registrador de herramientas correspondiente
  3. Actualizar la lista de herramientas en el README

Licencia

Este proyecto utiliza la licencia MIT. Consulte el archivo LICENSE para obtener más detalles.