PowerPoint MCP Server

Manipular apresentações do PowerPoint usando a biblioteca python-pptx.

GitHub
8

Documentação

PowerPoint MCP Server

Um servidor abrangente de Model Context Protocol (MCP) para manipulação de apresentações do PowerPoint usando python-pptx. Este servidor fornece acesso programático a operações do PowerPoint através do protocolo MCP, otimizado para uso com assistentes de IA como Claude no Cursor IDE.

Recursos

Gerenciamento Central de Apresentações

  • create_presentation - Criar apresentações do zero ou a partir de modelos
  • load_presentation - Carregar arquivos PowerPoint existentes para edição
  • save_presentation - Salvar apresentações com resolução automática de caminho
  • add_slide - Adicionar slides com diferentes layouts (título, conteúdo, em branco, etc.)
  • extract_text - Extrair todo o conteúdo de texto para análise
  • get_presentation_info - Obter metadados e informações de estrutura

Criação e Manipulação de Conteúdo

  • add_text_box - Formatação de texto rica (tamanho da fonte, negrito, itálico, cores)
  • add_image - Imagens de arquivos ou URLs com posicionamento preciso
  • add_chart - Gráficos orientados por dados (coluna, barra, linha, pizza, área)
  • create_from_json - Criação de apresentações orientada por esquema
  • add_professional_shape - Formas profissionais da biblioteca integrada

Análise Visual e Revisão

  • screenshot_slides - Gerar capturas de tela de slides de alta qualidade (somente Windows)
  • critique_presentation - Análise abrangente (design, conteúdo, acessibilidade, técnica)

Gerenciamento de Estilo e Automação

  • analyze_presentation_style - Extrair padrões de estilo para aprendizado
  • create_style_profile - Construir perfis de estilo reutilizáveis
  • apply_style_profile - Aplicar estilos aprendidos a apresentações
  • save_style_profile / load_style_profile - Persistir dados de estilo

Layout e Design Profissional

  • create_layout_grid - Grades de alinhamento profissionais
  • snap_to_grid - Ajustar formas às posições da grade
  • distribute_shapes - Distribuição uniforme de espaçamento
  • create_color_palette / apply_color_palette - Cores consistentes com a marca
  • create_typography_profile / apply_typography_style - Hierarquias tipográficas

Temas e Modelos Mestres

  • create_master_slide_theme - Temas de slides mestres com formatação consistente
  • apply_master_theme - Aplicar temas em apresentações inteiras
  • create_template - Modelos reutilizáveis com espaços reservados e lógica
  • apply_template - Aplicação de modelos orientada por dados
  • bulk_generate_presentations - Gerar múltiplas apresentações a partir de modelos

Instalação

  1. Instalar dependências:
pip install -r requirements.txt
  1. Verificar a instalação do python-pptx:
python -c "import pptx; print('python-pptx installed successfully')"

Uso

Iniciando o Servidor

python powerpoint_mcp_server.py

O servidor iniciará e aguardará mensagens do protocolo MCP via stdio.

Integração com o Cursor

  1. Copie cursor_config.json.example para cursor_config.json
  2. Atualize o caminho na configuração, se necessário
  3. Adicione às configurações MCP do seu Cursor

Exemplo de configuração:

{
  "mcpServers": {
    "powerpoint": {
      "command": "python",
      "args": ["./powerpoint_mcp_server.py"],
      "env": {},
      "description": "PowerPoint MCP Server for presentation manipulation"
    }
  }
}

Arquitetura

Integração MCP

  • Recursos: Expõe apresentações como recursos legíveis
  • Ferramentas: Fornece ferramentas abrangentes de manipulação do PowerPoint
  • Protocolo: Conformidade total com MCP e tratamento adequado de erros

Limitações

  • Uso de memória: As apresentações são mantidas em memória durante as operações
  • Formatos de arquivo: Suporta apenas o formato .pptx (PowerPoint 2007+)
  • Acesso concorrente: Operação de thread única
  • Complexidade de modelos: Recursos avançados de modelos podem não ser totalmente suportados

Licença

Este projeto é licenciado sob a Licença MIT.

Agradecimentos