PowerPoint Translator

Serviço MCP PowerPoint Translator

Um serviço Model Context Protocol (MCP) que fornece capacidades de tradução de PowerPoint usando modelos AWS Bedrock.

Recursos

• Traduzir apresentações PowerPoint para vários idiomas
• Preservar a formatação durante a tradução
• Suporte para modelos AWS Bedrock Nova
• Tratamento inteligente de nomes próprios, marcas e conteúdo especial
• Conformidade total com o protocolo MCP com inicialização e tratamento de ferramentas adequados
• Implementação de fallback quando a biblioteca MCP não está disponível

Idiomas Suportados

• Chinês Simplificado (zh-CN)
• Chinês Tradicional (zh-TW)
• Inglês (en)
• Japonês (ja)
• Coreano (ko)
• Francês (fr)
• Alemão (de)
• Espanhol (es)

Pré-requisitos

• Python 3.8+
• Conta AWS com acesso ao Bedrock
• Credenciais AWS configuradas (via aws configure ou variáveis de ambiente)

Instalação

Configuração Rápida

# Clone the repository
git clone https://github.com/yourusername/mcpppttranslator.git
cd mcpppttranslator

# Install dependencies
python server.py --install-deps

# Or use uv for faster installation
python server.py --install-deps --use-uv

Configuração de Ambiente Virtual (Recomendado)

# Create virtual environment with uv
python server.py --install-deps --use-uv --venv

# Or specify custom path
python server.py --install-deps --use-uv --venv --venv-path /path/to/custom/venv

Configuração do MCP

Opção 1: Configuração via AWS CLI (Recomendado)

Primeiro, configure suas credenciais AWS:

aws configure

Em seguida, adicione à sua configuração do Amazon Q:

{
  "mcpServers": {
    "ppt-translator": {
      "timeout": 300,
      "type": "stdio",
      "command": "python",
      "args": [
        "/path/to/mcpppttranslator/server.py",
        "--mcp"
      ],
      "env": {
        "AWS_REGION": "us-east-1",
        "DEFAULT_TARGET_LANGUAGE": "zh-CN"
      }
    }
  }
}

Opção 2: Configuração Direta de Credenciais

{
  "mcpServers": {
    "ppt-translator": {
      "timeout": 300,
      "type": "stdio",
      "command": "python",
      "args": [
        "/path/to/mcpppttranslator/server.py",
        "--mcp"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key",
        "AWS_REGION": "us-east-1",
        "DEFAULT_TARGET_LANGUAGE": "zh-CN"
      }
    }
  }
}

Uso

Com o Amazon Q

Após a configuração, você pode usar comandos em linguagem natural:

Translate my presentation.pptx to Japanese using the Nova model

Uso via Linha de Comando

# Run in MCP mode
python server.py --mcp

# Direct translation
python server.py --translate --input-file presentation.pptx --target-language ja

# List supported languages
python server.py --list-languages

Ferramentas Disponíveis

1. translate_ppt - Traduzir um documento PowerPoint

   • input_file: Caminho para o arquivo PowerPoint de entrada (obrigatório)
   • target_language: Código do idioma de destino (padrão: zh-CN)
   • output_file: Caminho para salvar o arquivo traduzido (opcional)
   • translation_method: Método de tradução, 'nova' ou 'claude' (padrão: nova)

2. list_supported_languages - Listar todos os idiomas de destino suportados

Argumentos de Linha de Comando

• --mcp: Executar em modo MCP
• --translate: Traduzir um arquivo PowerPoint
• --input-file: Caminho para o arquivo PowerPoint de entrada
• --target-language: Código do idioma de destino
• --output-file: Caminho para salvar o arquivo traduzido
• --model-id: ID do modelo de tradução (opções: 'amazon.nova-micro-v1:0', 'amazon.nova-lite-v1:0')
• --list-languages: Listar idiomas suportados
• --install-deps: Instalar dependências necessárias
• --use-uv: Usar o gerenciador de pacotes uv em vez de pip
• --venv: Criar e usar um ambiente virtual com uv
• --venv-path: Caminho para o ambiente virtual (padrão: ./venv)

Testes

Teste a funcionalidade do servidor MCP:

python test_mcp.py

Solução de Problemas

Problemas Comuns

1. Credenciais AWS: Certifique-se de que as credenciais AWS estejam configuradas corretamente via aws configure ou variáveis de ambiente.

2. Dependências Ausentes: Execute python server.py --install-deps para instalar os pacotes necessários.

3. Erros de Protocolo MCP: O servidor implementa conformidade total com o protocolo MCP. Se você encontrar erros de inicialização, certifique-se de estar usando um cliente MCP compatível.

4. Permissões de Arquivo: Certifique-se de que o arquivo server.py tenha permissões de execução: chmod +x server.py

Desenvolvimento

Desenvolvimento Local

1. Clone e configure:

   git clone https://github.com/yourusername/mcpppttranslator.git
   cd mcpppttranslator
   python server.py --install-deps --use-uv --venv
   

2. Teste o servidor:

   python test_mcp.py
   

Conformidade com o Protocolo MCP

Este servidor implementa a especificação completa do protocolo MCP, incluindo:

• Tratamento adequado do método initialize
• Métodos padrão tools/list e tools/call
• Formatação correta de respostas JSON-RPC 2.0
• Tratamento de erros e degradação graciosa
• Compatibilidade retroativa com métodos MCP legados

Licença

MIT