# 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
```bash
# 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)
```bash
# 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:
```bash
aws configure
```
Then add to your Amazon Q configuration:
```json
{
"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
```json
{
"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
```bash
# 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
1. **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)
2. **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:
```bash
python test_mcp.py
```
## Troubleshooting
### Common Issues
1. **AWS Credentials**: Ensure AWS credentials are properly configured via `aws configure` or environment variables.
2. **Missing Dependencies**: Run `python server.py --install-deps` to install required packages.
3. **MCP Protocol Errors**: The server implements full MCP protocol compliance. If you encounter initialization errors, ensure you're using a compatible MCP client.
4. **File Permissions**: Ensure the server.py file has execute permissions: `chmod +x server.py`
## Development
### Local Development
1. Clone and setup:
```bash
git clone https://github.com/yourusername/mcpppttranslator.git
cd mcpppttranslator
python server.py --install-deps --use-uv --venv
```
2. Test the server:
```bash
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
