项目简介

AiryLark 专业翻译服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,专门为大型语言模型 (LLM) 提供专业级高精度翻译服务。它通过标准化的 MCP 协议与客户端通信,使 LLM 能够便捷地调用高质量的翻译和翻译质量评估功能。

主要功能点

  • 专业级翻译: 提供分析规划、分段翻译和全文审校的三阶段翻译流程,确保专业领域文档的翻译质量。
  • 领域术语识别: 自动识别专业文本领域,提取关键术语并保证术语一致性。
  • 质量评估系统: 提供全面的翻译质量评估,包括准确性、流畅性、术语使用和风格一致性。
  • 多语言支持: 支持中文、英文、日语、韩语、法语、德语等多种语言互译。
  • 多种传输协议: 支持 Stdio, SSE, REST 等多种 MCP 传输协议,方便集成到不同的 LLM 应用中。
  • 工具接口: 提供 'translate_text' (文本翻译) 和 'evaluate_translation' (翻译质量评估) 两种 MCP 标准工具。
  • 资源接口: 提供 'supported_languages' 资源,列出服务器支持的语言列表。

安装步骤

  1. 安装 Node.js 和 npm: 确保已安装 Node.js (v18+) 和 npm 包管理器。

  2. 安装依赖: 在仓库的 'mcp-server' 目录下,运行 'npm install' 命令安装项目依赖。

    cd mcp-server
    npm install
  3. 配置环境变量:

    • 创建 '.env' 文件或设置系统环境变量。
    • 配置翻译 API 密钥、模型名称和 API 基地址,以及服务器端口等信息。
    • 必要的环境变量包括 'TRANSLATION_API_KEY', 'TRANSLATION_MODEL', 'TRANSLATION_BASE_URL'。可选配置端口 'PORT' 和运行模式 'MODE' (默认为 sse)。
    # 翻译API配置 (必须配置,请替换为您的API信息)
    TRANSLATION_API_KEY=your_api_key
    TRANSLATION_MODEL=your_model_name
    TRANSLATION_BASE_URL=your_api_base_url
    
    # 服务器配置 (可选)
    PORT=3031
    MODE=sse # 可选值: stdio, sse, rest
    ENDPOINT=/rest # REST 模式端点,默认为 /rest

服务器配置

对于 MCP 客户端,配置连接 AiryLark 专业翻译服务器时,需要提供服务器的启动命令和参数。以下是配置示例,客户端需要根据自身情况进行配置:

配置示例 (JSON 格式):

{
  "serverName": "airylark-translation-server",
  "command": "node",
  "args": [
    "dist/index.js"
  ],
  "env": {
    "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
    "TRANSLATION_MODEL": "<YOUR_MODEL>",
    "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
  }
}

参数说明:

  • 'serverName': 服务器名称,客户端用于标识和管理连接。可以自定义。
  • 'command': 启动服务器的命令。这里假设使用 Node.js 运行编译后的 'index.js' 文件。
  • 'args': 传递给启动命令的参数,例如 'dist/index.js' 指向服务器入口文件。
  • 'env': 环境变量配置,用于传递翻译 API 的密钥、模型等敏感信息。 请务必替换 '<YOUR_API_KEY>', '<YOUR_MODEL>', '<YOUR_API_URL>' 为您实际的 API 信息。 其他环境变量如 'PORT', 'MODE', 'ENDPOINT' 也可以在此处配置。

注意:

  • 上述配置为示例,实际配置可能需要根据客户端的具体要求进行调整。
  • 'dist/index.js' 是项目构建后的服务器入口文件路径。如果直接运行开发环境,可能需要将 'args' 修改为 '["src/index.ts"]' 并确保客户端支持 ts-node 或类似工具。
  • 请参考客户端的 MCP 服务器配置文档,了解如何正确配置和连接外部 MCP 服务器。

基本使用方法

  1. 启动服务器:

    • 开发环境: 运行 'npm run dev' 启动开发服务器。
    • 生产环境: 先运行 'npm run build' 构建项目,然后运行 'npm start' 启动生产服务器。
  2. 客户端调用:

    • 使用支持 MCP 协议的客户端 (如 Cursor, Claude Chat 或自定义 MCP 客户端 SDK) 连接到 AiryLark 专业翻译服务器。
    • 调用 'translate_text' 工具进行文本翻译,或调用 'evaluate_translation' 工具进行翻译质量评估。
    • 客户端需要配置正确的 MCP 服务器连接信息 (如上述 "服务器配置" 示例)。
    • 具体工具的使用方法和参数请参考仓库 README.md 文档和工具的参数定义。

信息

分类

AI与计算