Translationx

TranslationX is a Python-based MCP server that runs via the uv toolchain. It leverages the MCP CLI to load and execute TranslationX's main.py script, enabling seamless connection between your local project and the MCP ecosystem. To use it, first ensure you have uv installed and have added the mcp[cli] dependency so you can run MCP commands. The server expects an environment variable TRANSLATIONX_TOKEN for authentication with TranslationX services (such as X-DOC). Once configured, you can start the server by running the provided uv command and then point your MCP client (Cursor or other tools) to the translationx server entry, which will expose translation-related capabilities, including file-based translation and test runs as demonstrated in the repository’s tests and screenshots.

Prerequisites:

• Python 3.13 or newer
• uv installed and configured
• Access to the TranslationX MCP server repository (or local source at src/main.py)

Installation steps:

1. Install uv and MCP CLI support: uv add "mcp[cli]"

2. Install the Python runtime for MCP server (via uv): uv python install 3.13

3. Prepare a local MCP project for TranslationX: uv init mcp_server_translation

4. Copy the TranslationX src directory into your project directory as src (containing main.py or equivalent entrypoint).

5. Verify basic MCP server readiness: uv run --with mcp[cli] mcp run {YOUR_PATH}/src/main.py

6. Configure your MCP client (Cursor) with the translationx server settings as shown in the example configuration.

Tips and notes:

• The server is configured to read TRANSLATIONX_TOKEN for authentication with TranslationX services; replace <YOUR_TRANSLATIONX_TOKEN> with a valid token.
• On macOS, if you encounter shell escaping issues when building the command, ensure proper escaping for brackets in the--with argument (e.g., mcp[cli]).
• If the MCP server fails to start, verify that the path to src/main.py is correct and that Python 3.13 is active in uv.
• You can customize the environment or extend the mcpServers configuration to add more env vars or modify the command/args as needed for your setup.
• The translation capabilities rely on the TranslationX service; ensure network access and token validity to avoid runtime failures.