Powerpoint

Servidor MCP Powerpoint

Um projeto de servidor MCP que cria apresentações em PowerPoint

Principais mudanças deste fork

Usa a API do Stable Diffusion (ForgeUI/Automatic-1111) em vez do together ai.

Componentes

Ferramentas

O servidor implementa várias ferramentas:

• create-presentation: Inicia uma apresentação
  • Recebe "name" como argumento de string obrigatório
  • Cria um objeto de apresentação
• add-slide-title-only: Adiciona um slide de título à apresentação
  • Recebe "presentation_name" e "title" como argumentos de string obrigatórios
  • Cria um slide de título com "title" e o adiciona à apresentação
• add-slide-section-header: Adiciona um slide de cabeçalho de seção à apresentação
  • Recebe "presentation_name" e "header" como argumentos de string obrigatórios
  • Cria um slide de cabeçalho de seção com "header" (e opcionalmente "subtitle") e o adiciona à apresentação
• add-slide-title-content: Adiciona um slide de título com conteúdo à apresentação
  • Recebe "presentation_name", "title", "content" como argumentos de string obrigatórios
  • Cria um slide de título com conteúdo usando "title" e "content" e o adiciona à apresentação
• add-slide-title-with-table: Adiciona um slide de título com uma tabela
  • Recebe "presentation_name", "title", "data" como argumentos de string e array obrigatórios
  • Cria um slide de título com "title" e adiciona uma tabela construída dinamicamente a partir de data
• add-slide-title-with-chart: Adiciona um slide de título com um gráfico
  • Recebe "presentation_name", "title", "data" como argumentos de string e objeto obrigatórios
  • Cria um slide de título com "title" e adiciona um gráfico construído dinamicamente a partir de data. Tenta descobrir o melhor tipo de gráfico a partir da fonte de dados.
• add-slide-picture-with-caption: Adiciona um slide de imagem com legenda
  • Recebe "presentation_name", "title", "caption", "image_path" como argumentos de string obrigatórios
  • Cria um slide de imagem com legenda usando "title", "caption" e "image_path" fornecidos. Pode usar imagens criadas pela ferramenta "generate-and-save-image" ou usar um "image_path" fornecido pelo usuário (a imagem deve existir em folder_path)
• open-presentation: Abre uma apresentação para edição
  • Recebe "presentation_name" como argumento obrigatório
  • Abre a apresentação fornecida e salva automaticamente um backup dela como "backup.pptx"
  • Esta ferramenta permite que o cliente trabalhe com arquivos pptx existentes e adicione slides a eles. Apenas certifique-se de que o cliente chame a ferramenta "save-presentation" ao final.
• save-presentation: Salva a apresentação em um arquivo.
  • Recebe "presentation_name" como argumento obrigatório.
  • Salva a apresentação em folder_path. O cliente deve chamar esta ferramenta para finalizar o processo.
• generate-and-save-image: Gera uma imagem para a apresentação usando um modelo T2I
  • Recebe "prompt" e "file_name" como argumentos de string obrigatórios
  • Cria uma imagem usando a API do stable diffusion (ForgeUI/Automatic1111)

Configuração

Uma variável de ambiente é necessária para a geração de imagens via API ForgeUI

"env": 
{
  "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
  "SD_AUTH_USER": "your-username",  // Optional: if authentication is enabled
  "SD_AUTH_PASS": "your-password",  // Optional: if authentication is enabled
}

Um folder_path é obrigatório. Todas as apresentações e imagens serão salvas nesta pasta.

"--folder-path",
  "/path/to/decks_folder"

Início rápido

Instalação

Certifique-se de ter o UV instalado

MacOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Clone o repositório

git clone https://github.com/Ichigo3766/powerpoint-mcp.git

Claude Desktop (funciona com qualquer cliente mcp)

No MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

• --directory: o caminho onde você clonou o repositório acima (ex: /full/path/to/powerpoint-mcp/src)
• --folder-path: o caminho onde as apresentações e imagens do PowerPoint serão salvas. Também é o caminho onde você deve colocar quaisquer imagens que deseja que o servidor MCP use.

  # Add the server to your claude_desktop_config.json
  "mcpServers": {
    "powerpoint": {
      "command": "uv",
      "env": {
        "SD_WEBUI_URL": "http://your-sd-webui-url:7860",
        "SD_AUTH_USER": "your-username",  // Optional: if authentication is enabled
        "SD_AUTH_PASS": "your-password",  // Optional: if authentication is enabled
      },
      "args": [
        "--directory",
        "/path/to/powerpoint",
        "run",
        "powerpoint",
        "--folder-path",
        "/path/to/decks_folder"
      ]
    }
  }

Exemplos de uso

Create a presentation about fish, create some images and include tables and charts

Create a presentation about the attached paper. Please use the following images in the presentation:
author.jpeg

Supondo que você tenha o SQLite MCP Server instalado.

Review 2024 Sales Data table. Create a presentation showing current trends, use tables and charts as appropriate

Créditos

Este projeto é um fork de powerpoint por supercurses, com recursos e modificações adicionais. O projeto original forneceu a base para este servidor MCP.

Licença

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT. Para mais detalhes, consulte o arquivo LICENSE no repositório do projeto.