Office-PowerPoint-MCP-Server: ferramenta para criar e editar apresentações do PowerPoint por meio de assistentes de IA

O Office-PowerPoint-MCP-Server é uma ferramenta de servidor baseada no protocolo de contexto de modelo (MCP) projetada para criar, editar e gerenciar apresentações do PowerPoint por meio da biblioteca python-pptx. Ele permite que os usuários manipulem o PowerPoint diretamente por meio de assistentes de IA, como o Claude ou o Cursor, para criar slides, adicionar conteúdo, aplicar temas e muito mais. O projeto fornece 25 modelos de slides profissionais, suporta ajuste de texto dinâmico, fundos de gradiente e efeitos interativos e outras funções, adequados para usuários que precisam gerar rapidamente apresentações de alta qualidade. O projeto é de código aberto, o código está hospedado no GitHub, é fácil de instalar e oferece suporte para operação local e na nuvem.

Lista de funções

• Crie e salve apresentações do PowerPoint, com suporte a vários formatos de arquivo.
• Adicione vários tipos de slides, como páginas de título, páginas de conteúdo, painéis de dados, etc.
• Aplique 25 modelos de slides profissionais com ajustes dinâmicos de texto e planos de fundo em degradê.
• Suporta a inserção de caixas de texto, tabelas, gráficos, figuras e formas com ajuste automático de layout.
• Disponível em 4 esquemas de cores profissionais: azul moderno, cinza comercial, verde elegante e vermelho quente.
• Suporte a efeitos de animação, efeitos de transição e efeitos de foco interativos.
• Gerencie a estrutura e o conteúdo das apresentações com 32 ferramentas e 11 módulos.
• Valide automaticamente o texto e o layout para garantir que o conteúdo atenda aos padrões profissionais.

Usando a Ajuda

Processo de instalação

O Office-PowerPoint-MCP-Server oferece uma maneira fácil de instalar e executar. Veja a seguir as etapas detalhadas:

1. Repositório de código clone
   Execute o seguinte comando no terminal para fazer o download do código do projeto:

   git clone https://github.com/GongRzhe/Office-PowerPoint-MCP-Server.git
   cd Office-PowerPoint-MCP-Server
   

2. Instalação de dependências
   Use o pip do Python para instalar as dependências necessárias:

   pip install -r requirements.txt
   

   Como alternativa, use o setup_mcp.py O script conclui a instalação automaticamente:

   python setup_mcp.py
   

3. Configuração do servidor MCP
   Edite o arquivo de configuração de um cliente MCP, como o Claude Desktop ou o Cursor, para adicionar informações do servidor. A configuração global pode ser editada ~/.cursor/mcp.json::

   {
   "mcpServers": {
   "ppt": {
   "command": "python",
   "args": ["/path/to/ppt_mcp_server.py"],
   "env": {}
   }
   }
   }
   

   Se você usar o gerenciador de pacotes uvx, poderá executá-lo diretamente sem instalação local:

   {
   "mcpServers": {
   "ppt": {
   "command": "uvx",
   "args": ["--from", "office-powerpoint-mcp-server", "ppt_mcp_server"],
   "env": {}
   }
   }
   }
   

4. Iniciar o servidor
   Execute o seguinte comando para iniciar o servidor:

   python ppt_mcp_server.py
   

   Após a inicialização, o servidor interage com o assistente de IA por meio do protocolo MCP.

Funções principais

Abaixo está o fluxo de operação detalhado das principais funções:

1. Criação de uma nova apresentação
   Use a ferramenta MCP para criar uma nova apresentação:

   result = use_mcp_tool(server_name="ppt", tool_name="create_presentation", arguments={})
   presentation_id = result["presentation_id"]
   

   Isso gera um novo arquivo do PowerPoint e retorna o identificador exclusivo presentation_id.

2. Adicionar slide de título
   Adicione um slide de título e defina o título e o subtítulo:

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="add_slide",
   arguments={
   "layout_index": 0,  # 标题幻灯片布局
   "title": "我的演示文稿",
   "presentation_id": presentation_id
   }
   )
   slide_index = result["slide_index"]
   result = use_mcp_tool(
   server_name="ppt",
   tool_name="populate_placeholder",
   arguments={
   "slide_index": slide_index,
   "placeholder_idx": 1,  # 副标题占位符
   "text": "由 PowerPoint MCP 服务器创建",
   "presentation_id": presentation_id
   }
   )
   

3. Design profissional aplicado
   Aplique esquemas de cores e temas profissionais a slides ou apresentações inteiras:

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="apply_professional_design",
   arguments={
   "operation": "slide",
   "slide_type": "title_content",
   "color_scheme": "modern_blue",
   "title": "季度业务回顾",
   "content": [
   "收入比上季度增长 15%",
   "客户满意度达到 94% 的历史新高",
   "成功推出 3 项新产品功能",
   "团队新增 12 名优秀员工"
   ]
   }
   )
   

   Os esquemas de cores compatíveis incluem modern_bluee corporate_graye elegant_green responder cantando warm_red.

4. Inserção de gráficos e tabelas
   Adicione slides com gráficos:

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="add_slide_title_with_chart",
   arguments={
   "presentation_name": presentation_id,
   "title": "销售趋势",
   "data": {
   "labels": ["Q1", "Q2", "Q3", "Q4"],
   "values": [100, 120, 150, 180]
   }
   }
   )
   

5. Salvando uma apresentação
   Salve a apresentação como um arquivo:

   result = use_mcp_tool(
   server_name="ppt",
   tool_name="save_presentation",
   arguments={
   "file_path": "my_presentation.pptx",
   "presentation_id": presentation_id
   }
   )
   

6. Exibir modelos disponíveis
   Lista de todos os 25 modelos de slides profissionais:

   templates = use_mcp_tool(server_name="ppt", tool_name="list_slide_templates", arguments={})
   

Operação da função em destaque

• Ajuste dinâmico de textoAjuste automático do tamanho do texto e do layout com base no tamanho do conteúdo: O modelo suporta o ajuste automático do tamanho do texto e do layout com base no comprimento do conteúdo. Por exemplo, o slide de título ajustará automaticamente o tamanho da fonte com base no texto inserido.
• efeito interativoSuporte a efeitos interativos ao passar o mouse, como realce ou acionamento de animação, adequado para apresentações interativas.
• Correspondência profissional de cores: 4 esquemas de cores estão disponíveis, cada um contendo cores primárias, secundárias e de texto para otimizar o efeito visual.
• Ferramentas modularesO projeto consiste em 11 módulos (por exemplo chart_tools.pye transition_tools.pyAs 32 ferramentas abrangem todos os aspectos da criação de apresentações.

advertência

• Certifique-se de que o ambiente do Python tenha a opção python-pptx Biblioteca.
• Verifique as permissões do caminho do arquivo para evitar erros de permissão ao manipular arquivos.
• Ao usar o Claude Desktop ou o Cursor, você precisa reiniciar o cliente para aplicar a configuração do MCP.

cenário do aplicativo

1. relatório de negócios
   Os usuários corporativos podem gerar rapidamente relatórios comerciais trimestrais, adicionar gráficos e tabelas para apresentar dados e usar esquemas de cores profissionais para aprimorar as apresentações.
2. Educação e treinamento
   Os professores podem criar apresentações instrucionais e inserir gráficos dinâmicos e conteúdo interativo para chamar a atenção dos alunos.
3. Apresentação da conferência
   Os organizadores de eventos podem usar os modelos para criar rapidamente slides de conferências, adicionando animações e transições para aprimorar a experiência do público.
4. Apresentação da análise de dados
   Os analistas de dados podem gerar apresentações que incluem gráficos e linhas de tendência para apresentar visualmente os resultados de suas análises.

QA

1. Como instalar o Office-PowerPoint-MCP-Server?
   Clone o repositório do GitHub e execute pip install -r requirements.txtou usar setup_mcp.py Os scripts são instalados automaticamente.
2. Quais assistentes de IA são compatíveis?
   O suporte para clientes MCP, como Claude Desktop, Cursor, etc., requer configuração. mcp.json Documentação.
3. Como escolher um modelo de slide?
   fazer uso de list_slide_templates para ver todos os modelos e, em seguida, por meio da ferramenta add_slide A ferramenta especifica o tipo de modelo.
4. Ele oferece suporte à correspondência de cores personalizada?
   Atualmente, há 4 esquemas de cores profissionais, não totalmente personalizáveis, mas os parâmetros de cores podem ser modificados por código.