What is Polyglot Mcp

Polyglot is an open-source implementation of the Model Contexts Protocol (MCP) designed for translation services, providing a standardized method for handling translation requests across various languages using Claude Sonnet 3.5.

Use cases

Use cases include translating legal documents, medical reports, and general content across different languages, facilitating communication in multilingual environments, and enhancing accessibility for diverse audiences.

How to use

To use polyglot-mcp, install it via ‘uv’ or ‘pip’, create a TranslationRequest object specifying source and target languages, domain, formality, and text, then initialize a PolyglotClient to send the request and receive the translation response.

Key features

Key features include a standardized translation request format, support for multiple domains (legal, medical, general), control over formality levels (formal/informal), and integration with Claude Sonnet 3.5.

Where to use

Polyglot-mcp can be used in various fields that require translation services, such as legal, medical, and general communication, making it suitable for businesses, organizations, and developers.

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)

# 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

# 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:

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:

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:

import requests

response = requests.get("http://localhost:8001/health")
print(response.text)

Run the test client with:

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:

Development

To set up the development environment:

# 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