AiryLark Translation

by wizd

8 stars
340 downloads
Not rated
GitHub

About

Provides multilingual translation capabilities for applications by integrating with external translation APIs through a containerized Node.js server.

Details

Author
wizd
Repository
wizd/airylark-mcp-server
GitHub stars
8
Downloads
340
License
Other
Categories
Developer Tools, AI, API, Infrastructure, Other

- 三阶段翻译流程:分析、分段、审校
- 自动识别专业领域并保持术语一致性
- 提供翻译质量评估(准确性、流畅性等)
- 支持中、英、日、韩、法、德等多语言互译
- 保持原文风格与格式

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name AiryLark Translation
    Command (node, npx, python, etc.) docker
    Arguments
    • Argument 1 run
    • Argument 2 -i
    • Argument 3 --rm
    • Argument 4 -e
    • Argument 5 TRANSLATION_API_KEY
    • Argument 6 -e
    • Argument 7 TRANSLATION_MODEL
    • Argument 8 -e
    • Argument 9 TRANSLATION_BASE_URL
    • Argument 10 wizdy/airylark-mcp-server
    Environment
    • TRANSLATION_MODEL <YOUR_MODEL>
    • TRANSLATION_API_KEY <YOUR_API_KEY>
    • TRANSLATION_BASE_URL <YOUR_API_URL>

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

安装Node.js (v18+) 和 npm,安装依赖 (npm install),配置环境变量(TRANSLATION_API_KEY等),然后通过npm run dev启动开发服务器或npm run buildnpm start启动生产服务器。也可通过Docker部署。AI助手可通过MCP客户端配置连接,调用translate_textevaluate_translation工具。

translate_text

专业级文本翻译,自动适应不同领域和文体风格。参数: text (需要翻译的源文本), target_language (目标语言代码), source_language (可选) (源语言代码), high_quality (可选) (是否启用高精度翻译流程,默认为true)

evaluate_translation

对翻译结果进行全面质量评估,提供详细反馈。参数: original_text (原始文本), translated_text (翻译后的文本), detailed_feedback (可选) (是否提供详细反馈,默认为false)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "airylark translation": {
            "env": {
                "TRANSLATION_MODEL": "<YOUR_MODEL>",
                "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
                "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
            },
            "args": [
                "run",
                "-i",
                "--rm",
                "-e",
                "TRANSLATION_API_KEY",
                "-e",
                "TRANSLATION_MODEL",
                "-e",
                "TRANSLATION_BASE_URL",
                "wizdy/airylark-mcp-server"
            ],
            "command": "docker"
        }
    }
}

Linux

{
    "env": {
        "TRANSLATION_MODEL": "<YOUR_MODEL>",
        "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
        "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
    },
    "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRANSLATION_API_KEY",
        "-e",
        "TRANSLATION_MODEL",
        "-e",
        "TRANSLATION_BASE_URL",
        "wizdy/airylark-mcp-server"
    ],
    "command": "docker"
}

Macos

{
    "env": {
        "TRANSLATION_MODEL": "<YOUR_MODEL>",
        "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
        "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
    },
    "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRANSLATION_API_KEY",
        "-e",
        "TRANSLATION_MODEL",
        "-e",
        "TRANSLATION_BASE_URL",
        "wizdy/airylark-mcp-server"
    ],
    "command": "docker"
}

Windows

{
    "env": {
        "TRANSLATION_MODEL": "<YOUR_MODEL>",
        "TRANSLATION_API_KEY": "<YOUR_API_KEY>",
        "TRANSLATION_BASE_URL": "<YOUR_API_URL>"
    },
    "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TRANSLATION_API_KEY",
        "-e",
        "TRANSLATION_MODEL",
        "-e",
        "TRANSLATION_BASE_URL",
        "wizdy/airylark-mcp-server"
    ],
    "command": "docker"
}

AiryLark MCP 专业翻译服务器

License: Custom-blue.svg)

这是AiryLark项目的ModelContextProtocol(MCP)服务器模块,提供专业级高精度翻译服务接口。MCP是一种标准协议,允许智能助手与外部服务进行结构化交互,使复杂翻译能力可直接被Claude等大型AI模型调用。

专业翻译优势

- 三阶段翻译流程:分析规划、分段翻译、全文审校,确保专业领域文档的翻译质量
- 领域术语识别:自动识别专业文本领域,提取关键术语并确保术语一致性
- 质量评估系统:提供全面翻译质量评估,包括准确性、流畅性、术语使用和风格一致性
- 多语言支持:支持中文、英文、日语、韩语、法语、德语等多种语言互译
- 风格与格式保持:根据文本类型自动调整翻译风格,保持原文的专业性和表达方式

适用场景

- 技术文档翻译:软件文档、API文档、技术规范等专业内容翻译
- 学术论文翻译:确保学术术语准确,保持学术文体风格
- 法律文件翻译:保证法律术语准确性和表述精确性
- 医疗资料翻译:专业医学术语翻译和医疗文献本地化
- 金融报告翻译:准确翻译金融术语和复杂财务概念

安装

1. 确保已安装Node.js (v18+)和npm

2. 安装依赖:

cd mcp-server
npm install

3. 配置环境变量:

创建.env文件或设置以下环境变量:

# 翻译API配置
TRANSLATION_API_KEY=your_api_key
TRANSLATION_MODEL=your_model_name
TRANSLATION_BASE_URL=your_api_base_url

服务器配置

PORT=3031 # MCP服务器端口,可选,默认3031

使用方法

开发环境

启动开发服务器:

npm run dev

生产环境

构建并启动服务器:

npm run build
npm start

MCP工具接口

服务器提供以下MCP标准工具:

1. 翻译工具 (translate_text)

专业级文本翻译,自动适应不同领域和文体风格。

参数:
- text: 需要翻译的源文本
- target_language: 目标语言代码 (如'zh'、'en'、'ja'等)
- source_language: (可选)源语言代码
- high_quality: (可选)是否启用高精度翻译流程,默认为true

使用场景:
- 设置high_quality=true用于专业文档、学术论文等对精度要求高的场景
- 设置high_quality=false用于非正式内容或需要快速翻译的场景

2. 翻译质量评估工具 (evaluate_translation)

对翻译结果进行全面质量评估,提供详细反馈。

参数:
- original_text: 原始文本
- translated_text: 翻译后的文本
- detailed_feedback: (可选)是否提供详细反馈,默认为false

评估指标:
- 准确性:译文是否准确传达原文意思
- 流畅性:译文是否符合目标语言表达习惯
- 术语使用:专业术语翻译的准确性和一致性
- 风格一致性:译文是否保持原文风格

资源接口

- supported_languages: 支持的语言列表
- URI: languages://list

与AI助手集成

本服务器设计为与支持MCP协议的AI助手无缝集成,使AI能够提供专业级翻译服务:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";

// 连接到MCP服务器
const transport = new SSEClientTransport("http://localhost:3031");
const client = new Client(
{ name: "assistant-client", version: "1.0.0" },
{ capabilities: { tools: {} } }
);
await client.connect(transport);

// 调用专业翻译工具
const result = await client.callTool({
name: "translate_text",
arguments: {
text: "The mitochondrion is the powerhouse of the cell.",
target_language: "zh",
high_quality: true
}
});

console.log(result.content[0].text);

Claude Chat与Cursor等MCP客户端配置

在支持MCP协议的AI助手应用中,可通过以下方式配置与AiryLark翻译服务器的连接:

Cursor配置

在Cursor设置或配置文件中添加以下MCP服务器配置:

{
  "mcpServers": {
    "airylark-translation": {
      "url": "https://airylark-mcp.vcorp.ai/sse"
    }
  }
}

Claude Chat配置

在Claude Chat中,可以通过以下步骤开启MCP服务器连接:

1. 进入设置页面
2. 找到"开发者设置"或"外部工具"选项
3. 添加新的MCP服务器,填写名称与URL
4. 服务器URL填写 https://airylark-mcp.vcorp.ai/sse

配置完成后,AI助手便可以使用"translate_text"和"evaluate_translation"工具,轻松处理各类专业文档翻译需求。

服务器配置与运行

AiryLark MCP服务器支持多种部署和运行方式,以下是常用配置方法:

Docker部署

使用官方发布的Docker镜像是最简单的部署方式:

# 拉取官方镜像
docker pull wizdy/airylark-mcp-server

运行容器

docker run -p 3031:3031 --env-file .env -d wizdy/airylark-mcp-server

Docker Compose部署

使用项目提供的docker-compose.yml文件,配合官方镜像可以更方便地管理服务:

```yaml

docker-compose.yml 示例

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.