Content
# Polyglot - Model Contexts Protocol for Translation
Polyglot is an open-source implementation of the Model Contexts Protocol (MCP) focused on translation services. It provides a standardized way to handle translation requests across multiple languages using Claude Sonnet 3.5.
## Supported Languages
- Arabic (ar)
- Chinese (zh)
- English (en)
- French (fr)
- Russian (ru)
- Spanish (es)
## Features
- Standardized translation request format
- Support for multiple domains (legal, medical, general)
- Formality level control (formal/informal)
- Claude Sonnet 3.5 integration
- MCP protocol server (via FastMCP)
- API key authentication
## Installation
### Using uv (Recommended)
```bash
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install the package and its dependencies
uv pip install .
# For development, install with dev dependencies
uv pip install ".[dev]"
```
### Using pip
```bash
# Install the package and its dependencies
pip install .
# For development, install with dev dependencies
pip install ".[dev]"
```
## Configuration
1. Create a `.env` file in your project root:
```bash
ANTHROPIC_API_KEY=your_api_key_here
```
2. Make sure to keep your API key secure and never commit it to version control.
## Running the MCP Server
To run the MCP server, use the following command:
```bash
uv run polyglot/server.py
```
This will start the server on the configured port (default: 8001).
## Testing the MCP Server
You can test the MCP server using a simple client script. For example, to test the health check resource, create a file named `test_client.py` with the following content:
```python
import requests
response = requests.get("http://localhost:8001/health")
print(response.text)
```
Run the test client with:
```bash
uv run test_client.py
```
You should see the output: "Service is healthy".
## Environment Variables
Make sure to set your Anthropic API key in a `.env` file in the project root:
```
ANTHROPIC_API_KEY=your_api_key_here
```
## Additional Notes
- The server uses the Model Context Protocol (MCP) to expose tools and resources.
- Ensure all dependencies are installed using `uv` or `pip`.
- For more details, refer to the project documentation.
## Protocol Specification
The translation request follows this JSON structure:
```json
{
"version": "1.0",
"type": "translation_request",
"metadata": {
"source_language": "fr",
"target_language": "en",
"domain": "legal",
"formality": "formal",
"api_key": "your_api_key_here" // Required for authentication
},
"data": {
"text": "Le contrat a été signé hier à Genève."
}
}
```
## Development
To set up the development environment:
```bash
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create and activate a virtual environment
uv venv
source .venv/bin/activate # On Unix/macOS
# or
.venv\Scripts\activate # On Windows
# Install development dependencies
uv pip install ".[dev]"
```
## License
MIT License
MCP Store