Lara Translate MCP 服务器

一个用于 Lara Translate API 的模型上下文协议 (MCP) 服务器，支持语言检测和上下文感知翻译，从而实现强大的翻译功能。

目录

• 简介
  • 什么是 MCP？
  • Lara Translate MCP 的工作原理
• 特性
• 可用工具
• 前提条件
• 安装与设置
  • 选项 1：使用 Docker（推荐）
  • 选项 2：使用 NPX
  • 选项 3：从源代码构建（推荐用于开发）
• 配置位置
• 验证安装
• 使用示例
  • 基本翻译
  • 带指令的翻译
• 支持

简介

什么是 MCP？

模型上下文协议 (MCP) 是一种标准化的通信协议，允许 AI 应用程序连接到外部工具和服务。 MCP 服务器充当 AI 模型和特定功能之间的桥梁，使 AI 应用程序能够执行超出其内置能力的专门任务。

Lara Translate MCP 的工作原理

Lara Translate MCP 服务器使 AI 应用程序能够访问 Lara Translate API。 当与 MCP 兼容的 AI 应用程序集成时：

1. 连接：AI 应用程序连接到 Lara Translate MCP 服务器
2. 请求：当需要翻译时，应用程序向 MCP 服务器发送结构化请求
3. 处理：MCP 服务器将请求转发到 Lara Translate 的 API
4. 响应：翻译结果返回给 AI 应用程序

这种集成允许 AI 应用程序将高质量的翻译无缝地整合到它们的工作流程中，而无需直接实现翻译 API。

特性

• 语言检测：自动检测源语言（如果未指定）
• 上下文感知翻译：提供上下文提示以提高翻译质量
• 自定义指令：使用特定指令微调翻译行为
• 多语言支持：在多种语言对之间进行翻译

可用工具

1. translate
   • 在语言之间翻译文本，支持语言检测和上下文感知翻译
   • 输入：
     • text (数组): 要翻译的文本块数组，每个文本块包含：
       • text (字符串): 文本内容
       • translatable (布尔值): 此文本块是否应该被翻译
     • source (可选字符串): 源语言代码 (例如, 'en-EN' 代表英语)
     • target (字符串): 目标语言代码 (例如, 'it-IT' 代表意大利语)
     • context (可选字符串): 用于提高翻译质量的附加上下文
     • instructions (可选字符串数组): 用于调整翻译行为的指令
     • source_hint (可选字符串): 用于语言检测的提示
   • 返回：翻译后的文本块，保持原始结构

前提条件

在安装之前，您需要：

1. 从 Lara Translate 获取 API 凭据：
   • 在 Lara 网站 上创建一个帐户
   • 订阅任何计划（包括免费层）
   • 导航到您帐户中的 API 部分
   • 生成一对新的 Lara API 凭据
   • 安全地存储您的 LARA_ACCESS_KEY_ID 和 LARA_ACCESS_KEY_SECRET

注意：如果您丢失了凭据，它们将无法恢复，您需要生成新的凭据。

安装与设置

有三种方法可以安装和运行 Lara Translate MCP 服务器：

选项 1：使用 Docker（推荐）

此选项需要在您的系统上安装 Docker。

1. 将以下内容添加到您的 MCP 配置文件：

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

2. 将 <YOUR_ACCESS_KEY_ID> 和 <YOUR_ACCESS_KEY_SECRET> 替换为您实际的 Lara API 凭据。

选项 2：使用 NPX

此选项需要在您的系统上安装 Node.js。

1. 将以下内容添加到您的 MCP 配置文件：

{
  "mcpServers": {
    "lara-translate": {
      "command": "npx",
      "args": ["-y", "@translated/lara-mcp"],
      "env": {
        "LARA_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "LARA_ACCESS_KEY_SECRET": "<YOUR_ACCESS_KEY_SECRET>"
      }
    }
  }
}

2. 将 <YOUR_ACCESS_KEY_ID> 和 <YOUR_ACCESS_KEY_SECRET> 替换为您实际的 Lara API 凭据。

选项 3：从源代码构建（推荐用于开发）

使用 Node.js

1. 克隆存储库：

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

2. 安装依赖项并构建：

# 安装依赖项
pnpm install

# 构建
pnpm run build

3. 将以下内容添加到您的 MCP 配置文件：

{
  "mcpServers": {
    "lara-translate": {
      "command": "node",
      "args": ["<FULL_PATH_TO_PROJECT_FOLDER>/dist/index.js"],
      "env": {
        "LARA_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
        "LARA_ACCESS_KEY_SECRET": "<YOUR_ACCESS_KEY_SECRET>"
      }
    }
  }
}

4. 替换：
   • <FULL_PATH_TO_PROJECT_FOLDER> 替换为您的项目文件夹的绝对路径
   • <YOUR_ACCESS_KEY_ID> 和 <YOUR_ACCESS_KEY_SECRET> 替换为您实际的 Lara API 凭据。

构建 Docker 镜像

1. 克隆存储库：

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

2. 构建 Docker 镜像：

docker build -t lara-mcp .

3. 将以下内容添加到您的 MCP 配置文件：

{
  "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_ACCESS_KEY_ID>",
        "LARA_ACCESS_KEY_SECRET": "<YOUR_ACCESS_KEY_SECRET>"
      }
    }
  }
}

4. 将 <YOUR_ACCESS_KEY_ID> 和 <YOUR_ACCESS_KEY_SECRET> 替换为您实际的凭据。

配置位置

MCP 配置文件的位置取决于您使用的 AI 应用程序。 常见位置包括：

• Claude Desktop:

  • Windows: %APPDATA%\Claude Desktop\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude Desktop/claude_desktop_config.json
  • Linux: ~/.config/Claude Desktop/claude_desktop_config.json

• 其他应用程序: 请参阅特定应用程序的文档以获取配置文件位置

如果配置文件不存在，您需要创建它。

验证安装

设置 MCP 服务器并重新启动 AI 应用程序后：

1. 打开您的 MCP 兼容应用程序
2. 通过尝试一个简单的翻译命令来检查翻译功能是否可用：

   Translate with Lara "Hello world" to Spanish
   

使用示例

基本翻译

提示：

Translate with Lara "la terra è rossa", I'm talking with a tennis player.

API 输入：

{
    "text": [
        { "text": "la terra è rossa", "translatable": true }
    ],
    "target": "en-US",
    "context": "Conversation with a tennis player"
}

API 输出：

[
    {
        "text": "The clay is red.",
        "translatable": true
    }
]

带指令的翻译

提示：

Translate with Lara "Buongiorno, come stai?" to English, use a formal tone.

API 输入：

{
    "text": [
        { "text": "Buongiorno, come stai?", "translatable": true }
    ],
    "target": "en-US",
    "instructions": ["Use a formal tone"]
}

API 输出：

[
    {
        "text": "Good morning, how are you?",
        "translatable": true
    }
]

支持

有关 Lara Translate API 的问题，请联系 Lara Support。

有关此 MCP 服务器的问题，请在 GitHub 存储库上打开一个 issue。