Lara Translate

🚀 Lara Translate Translation Server Guide

Lara Translate is a powerful translation tool that supports integration through the MCP (Machine Control Protocol) interface. This document will guide you on how to install and configure the Lara Translate translation server.

🚀 Quick Start

✨ Features

• Powerful translation capabilities.
• Support for integration via the MCP interface.

📦 Installation

There are multiple ways to install Lara Translate. Choose the one that suits you best:

Method 1: Install using Docker container

1. Open your terminal and run the following command to pull the pre-built Docker image:

docker pull translatednet/lara-mcp

2. Add the image to your MCP configuration file. Here is an example configuration:

{
    "mcpServers": {
        "lara-translate": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "LARA_ACCESS_KEY_ID",
                "-e",
                "LARA_ACCESS_KEY_SECRET",
                "translatednet/lara-mcp"
            ],
            "env": {
                "LARA_ACCESS_KEY_ID": "<YOUR_API_KEY>",
                "LARA_ACCESS_KEY_SECRET": "<YOUR_API_SECRET>"
            }
        }
    }
}

Please replace <YOUR_API_KEY> and <YOUR_API_SECRET> with the actual keys you obtained from Lara Translate.

Method 2: Install using npm package

1. Run the following command in your terminal to install the npm package:

npm install @translated/lara-mcp

2. Add the following content to your MCP configuration file:

{
    "mcpServers": {
        "lara-translate": {
            "command": "node",
            "args": ["node_modules/@translated/lara-mcp/dist/index.js"],
            "env": {
                "LARA_ACCESS_KEY_ID": "<YOUR_API_KEY>",
                "LARA_ACCESS_KEY_SECRET": "<YOUR_API_SECRET>"
            }
        }
    }
}

Method 3: Build from source code (suitable for development)

Build using Node.js

1. Clone the repository:

git clone https://github.com/translated/lara-mcp.git
cd lara-mcp

2. Install dependencies and build the project:

pnpm install
pnpm run build

3. Add the following content to your MCP configuration file:

{
    "mcpServers": {
        "lara-translate": {
            "command": "node",
            "args": ["<Absolute path of the project>/dist/index.js"],
            "env": {
                "LARA_ACCESS_KEY_ID": "<YOUR_API_KEY>",
                "LARA_ACCESS_KEY_SECRET": "<YOUR_API_SECRET>"
            }
        }
    }
}

Please replace <Absolute path of the project> with the actual path of your project.

Build a Docker image

1. Clone the repository and build the image:

git clone https://github.com/translated/lara-mcp.git
cd lara-mcp
docker build -t lara-mcp .

2. Add the following content to your MCP configuration file:

{
    "mcpServers": {
        "lara-translate": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "LARA_ACCESS_KEY_ID",
                "-e",
                "LARA_ACCESS_KEY_SECRET",
                "lara-mcp"
            ],
            "env": {
                "LARA_ACCESS_KEY_ID": "<YOUR_API_KEY>",
                "LARA_ACCESS_KEY_SECRET": "<YOUR_API_SECRET>"
            }
        }
    }
}

Configuration File Location

Depending on the operating system you are using, the location of the configuration file is as follows:

• Windows: %APPDATA%\lara-mcp\config.json
• MacOS: ~/Library/Application Support/lara-mcp/config.json
• Linux: $HOME/.config/lara-mcp/config.json

Verify the Installation

1. Start your MCP service.
2. Send the following test request to verify if the connection is successful:

curl -X POST http://localhost:Port/api/v1/translate \
    -H "Content-Type: application/json" \
    -d '{"text":"Hello, World!","source_lang":"en","target_lang":"zh"}'

If a normal result is returned, it means the installation was successful.

💻 Usage Examples

Basic Usage

Request:

{
    "text": "Hello, World!",
    "source_lang": "en",
    "target_lang": "zh"
}

Response:

{
    "translated_text": "你好，世界！",
    "status": "success"
}

Advanced Usage

Request:

[
    {"text": "Hello", "source_lang": "en", "target_lang": "zh"},
    {"text": "Goodbye", "source_lang": "en", "target_lang": "zh"}
]

Response:

[
    {"translated_text": "你好", "status": "success"},
    {"translated_text": "再见", "status": "success"}
]

⚠️ Important Note

• Ensure that your API key and secret are kept secure to avoid leakage.
• Adjust the server configuration and performance parameters according to your actual needs.

If you have any questions, please visit the Lara Translate official documentation or contact technical support.