MCP Translation Server

The MCP Translation Server provides high-performance bidirectional translation between Manchu and Chinese, combining advanced morphology analysis with a powerful translation engine. It helps you build language-enabled applications by delivering accurate, context-aware translations and rich linguistic insights.

How to use

You can use the MCP Translation Server with your MCP client by sending translation requests that specify the input text and both the source and target languages. The server exposes endpoints for translating text and for analyzing morphology, enabling you to build workflows that automatically analyze linguistic structure and produce high-quality translations.

How to install

Prerequisites you need before installation include a Python 3.x runtime and standard development tools.

# 1. Clone the project
git clone https://github.com/yourusername/mcp-translation-server.git
cd mcp-translation-server

# 2. Create and activate a virtual environment
python -m venv venv

# Linux/macOS
source venv/bin/activate

# Windows
venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

Next, prepare configuration by creating a runtime config from a template and then customize it to your environment.

# Copy a configuration template to create a working config
cp config/config.example.json config/config.json

# Open and edit the configuration as needed (using your preferred editor)

If you prefer a Python-based configuration approach, you can copy and customize the example Python config as follows.

# Copy example Python config to active config
cp config.example.py config.py

# Edit config.py with your settings (API keys, paths, etc.)
vim config.py

# Set required environment variables for security and access
export MCP_SECRET_KEY="your-secure-random-string"
export MCP_API_TOKEN="your-api-token"
export MCP_REDIS_PASSWORD="your-redis-password"  # Optional
export MCP_SMTP_PASSWORD="your-smtp-password"    # Optional

Finally, start the server to run it locally and begin handling translation requests.

python server.py

Additional configuration and notes

Environment variables shown in the configuration template are required to secure and operate the server. These include a secret key for sessions, an API token for authentication, and optional credentials for Redis and SMTP services. Keep sensitive values out of version control and rotate credentials regularly.

If you want to run a demonstration or a comprehensive demo locally, you can also run the provided demo script before starting the translation server.

Security practices to follow:

• Never commit configuration files containing secrets to version control.
• Use strong, random values for secret keys and API tokens.
• Store credentials in environment variables whenever possible.
• Keep your environment tidy and secure, with restricted access to sensitive data.

API basics

The server exposes endpoints for translation and morphology analysis. You can route client requests to these endpoints to perform real-time translations and linguistic analyses within your application.

Troubleshooting tips

If the server fails to start, ensure your Python environment is correctly configured, dependencies are installed, and the configuration file contains valid values for required keys. Check that the environment variables are set in the session that launches the server.

Available tools

translate

Translate text between Manchu and Chinese with context-aware processing and integrated morphology analysis.

analyze

Perform morphology analysis on input text to understand word structure, affixes, and phonology.