PPT-Agent

Crie, edite e gerencie apresentações do PowerPoint usando modelos de linguagem de grande escala.

GitHub
1

Documentação

Servidor MCP PPT-Agent

O servidor MCP PPT-Agent fornece a capacidade de criar, editar e gerenciar apresentações do PowerPoint por meio de modelos de linguagem grandes (LLMs). O servidor implementa a especificação Model Context Protocol (MCP), permitindo que LLMs interajam com as ferramentas do PPT-Agent por meio de uma interface padrão.

Visão geral dos recursos

O servidor MCP PPT-Agent oferece os seguintes recursos:

  • Criar e salvar apresentações do PowerPoint
  • Adicionar e gerenciar slides
  • Definir cores de fundo e fundos SVG dos slides
  • Adicionar várias formas e linhas
  • Adicionar caixas de texto e texto formatado
  • Importar imagens SVG
  • Adicionar imagens
  • Obter informações existentes dos slides

Arquitetura técnica

  • Estrutura principal: implementa funcionalidades do servidor MCP usando o SDK do Model Context Protocol
  • Camada de transporte: suporta transmissão STDIO (entrada/saída padrão), facilitando a integração com clientes LLM como o Claude
  • Implementação de ferramentas: fornece funcionalidades de operação do PowerPoint baseadas na biblioteca Aspose.Slides
  • Processamento assíncrono: implementa processamento de resposta assíncrono usando o Project Reactor

Construindo o projeto

Construa o projeto usando Maven:

mvn clean package

Isso gerará dois arquivos JAR:

  • Arquivo JAR padrão: target/pptagent-0.0.1-SNAPSHOT.jar
  • Arquivo JAR executável com todas as dependências: target/pptagent-0.0.1-SNAPSHOT-jar-with-dependencies.jar

Executando o servidor

Executando com o comando Java

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

Integração com o Claude Desktop

Para usar este servidor MCP no Claude Desktop, você precisa editar o arquivo de configuração do Claude Desktop e adicionar o PPT-Agent como um servidor MCP:

  1. Encontre o arquivo de configuração do Claude Desktop:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  2. Adicione a configuração do PPT-Agent:

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

Entendido! Segue abaixo a versão complementar no estilo do seu README atual, listando apenas os nomes das ferramentas e uma descrição de uma frase sobre a funcionalidade. Você pode inserir diretamente estas informações na seção "Ferramentas disponíveis" para enriquecer a lista de ferramentas.

Ferramentas básicas

  • createPresentation - Cria uma nova apresentação em branco
  • savePresentation - Salva a apresentação no caminho especificado

Ferramentas de slides

  • addSlide - Adiciona um novo slide
  • selectSlide - Seleciona o slide atual para operação

Ferramentas de fundo

  • setBackgroundColor - Define a cor de fundo do slide
  • setBackgroundSvg - Define o fundo SVG do slide

Ferramentas de formas

  • addShape - Adiciona formas ao slide
  • addLine - Adiciona linhas ao slide

Ferramentas de gráficos

  • addColumnChart - Adiciona gráfico de barras ao slide
  • addPieChart - Adiciona gráfico de pizza ao slide
  • addLineChart - Adiciona gráfico de linhas ao slide

Ferramentas de animação

  • addAnimation - Adiciona efeitos de animação a formas
  • addParagraphAnimation - Adiciona efeitos de animação a parágrafos de texto

Ferramentas de imagem/mídia

  • addPictureFrameWithAspectRatio - Adiciona imagem mantendo a proporção original
  • addPictureFrameFromBase64 - Adiciona imagem por meio de dados Base64
  • addPictureFrameWithFormat - Adiciona imagem com borda e rotação configuradas
  • addPictureFrameFromBase64WithFormat - Adiciona imagem por meio de dados Base64 com borda e rotação configuradas

Ferramentas SVG

  • addSvgImage - Adiciona imagem SVG ao slide

Ferramentas de texto

  • addTextBox - Adiciona caixa de texto ao slide
  • setFormattedText - Define texto formatado da forma

Ferramentas de informação

  • getShapesInfo - Obtém informações de todas as formas no slide
  • getSlideCount - Obtém o número de slides da apresentação

Exemplos de uso

A seguir estão alguns exemplos de uso que mostram como utilizar as ferramentas do PPT-Agent por meio de um LLM:

  1. Criar uma nova apresentação:

    请创建一个新的演示文稿

  2. Adicionar slide de título:

    在演示文稿中添加一个标题幻灯片，然后添加标题"PPT-Agent演示"

  3. Adicionar slide de conteúdo:

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

Detalhes técnicos

O servidor MCP PPT-Agent utiliza as seguintes tecnologias:

  • Java 16
  • Aspose.Slides (para operações de PPT)
  • Model Context Protocol SDK (para implementação do MCP)
  • Project Reactor (para processamento de resposta assíncrono)

Personalização e extensão

Para adicionar novas ferramentas, você precisa:

  1. Adicionar um novo método na classe de ferramentas existente
  2. Criar uma nova especificação de ferramenta no registrador de ferramentas correspondente
  3. Atualizar a lista de ferramentas no README

Licença

Este projeto é licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter detalhes.