PowerPoint Translator MCP Service

A Model Context Protocol (MCP) service that provides PowerPoint translation capabilities using AWS Bedrock models.

Features

Translate PowerPoint presentations to multiple languages
Preserve formatting during translation
Support for AWS Bedrock Nova models
Intelligent handling of proper nouns, brand names, and special content
Full MCP protocol compliance with proper initialization and tool handling
Fallback implementation when MCP library is not available

Supported Languages

Simplified Chinese (zh-CN)
Traditional Chinese (zh-TW)
English (en)
Japanese (ja)
Korean (ko)
French (fr)
German (de)
Spanish (es)

Prerequisites

Python 3.8+
AWS account with Bedrock access
AWS credentials configured (via aws configure or environment variables)

Installation

Quick Setup

# 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

Virtual Environment Setup (Recommended)

# 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

MCP Configuration

Option 1: AWS CLI Configuration (Recommended)

First, configure your AWS credentials:

aws configure

Then add to your Amazon Q configuration:

{
  "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"
      }
    }
  }
}

Option 2: Direct Credential Configuration

{
  "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"
      }
    }
  }
}

Usage

With Amazon Q

Once configured, you can use natural language commands:

Translate my presentation.pptx to Japanese using the Nova model

Command Line Usage

# 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

Available Tools

translate_ppt - Translate a PowerPoint document
- input_file: Path to the input PowerPoint file (required)
- target_language: Target language code (default: zh-CN)
- output_file: Path to save the translated file (optional)
- translation_method: Translation method, 'nova' or 'claude' (default: nova)
list_supported_languages - List all supported target languages

Command Line Arguments

--mcp: Run in MCP mode
--translate: Translate a PowerPoint file
--input-file: Path to the input PowerPoint file
--target-language: Target language code
--output-file: Path to save the translated file
--model-id: Translation model ID (choices: 'amazon.nova-micro-v1:0', 'amazon.nova-lite-v1:0')
--list-languages: List supported languages
--install-deps: Install required dependencies
--use-uv: Use uv package manager instead of pip
--venv: Create and use a virtual environment with uv
--venv-path: Path for the virtual environment (default: ./venv)

Testing

Test the MCP server functionality:

python test_mcp.py

Troubleshooting

Common Issues

AWS Credentials: Ensure AWS credentials are properly configured via aws configure or environment variables.
Missing Dependencies: Run python server.py --install-deps to install required packages.
MCP Protocol Errors: The server implements full MCP protocol compliance. If you encounter initialization errors, ensure you're using a compatible MCP client.
File Permissions: Ensure the server.py file has execute permissions: chmod +x server.py

Development

Local Development

Clone and setup:

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

Test the server:
```
python test_mcp.py
```

MCP Protocol Compliance

This server implements the full MCP protocol specification including:

Proper initialize method handling
Standard tools/list and tools/call methods
Correct JSON-RPC 2.0 response formatting
Error handling and graceful degradation
Backward compatibility with legacy MCP methods

License

MIT