RongjieChen/luhuo_qwen3_mt_mcp_server

炉火基于 Qwen3-MT 的翻译 MCP Server

基于阿里通义千问翻译模型 Qwen3-MT https://help.aliyun.com/zh/model-studio/machine-translation 的 MCP（Model Context Protocol）服务器，支持 92 种语言互译、流式翻译、术语干预和领域提示等高级功能。

项目简介

本项目是一个基于 FastMCP 框架开发的机器翻译服务器，集成了阿里通义千问翻译模型（Qwen3-MT）的强大翻译能力。通过 MCP 协议，可以轻松集成到各种 AI 应用和工具中，提供高质量的多语言翻译服务。

核心特性

• 🌍 多语言支持：支持 92 种语言互译，包括中、英、日、韩、法、西、德、泰、印尼、越、阿等主流语言
• 🚀 双模型选择：支持 qwen-mt-plus（高质量）和 qwen-mt-turbo（高速度）两种模型
• 📡 流式翻译：支持实时流式翻译，提供更好的用户体验
• 🎯 术语干预：支持自定义术语词典，确保专业术语翻译准确性
• 🏢 领域提示：支持领域特定翻译，如医学、法律、技术、商务等
• 🔍 自动语言检测：智能识别源语言，无需手动指定

支持的模型

部署指南

环境要求

• Python 3.10+
• 阿里云百炼 API 密钥

源码安装步骤

1. 克隆项目

git clone https://github.com/RongjieChen/luhuo_qwen3_mt_mcp_server.git
cd luhuo_qwen3_mt_mcp_server

2. 安装依赖

# 使用uv安装
uv sync

3. 配置环境变量

创建 .env 文件或直接设置环境变量：

# API密钥（必需）
export DASHSCOPE_API_KEY="your-dashscope-api-key"

# 模型配置（可选）
# 默认使用的翻译模型，支持 qwen-mt-plus 或 qwen-mt-turbo
# 如果不设置，默认使用 qwen-mt-turbo
export QWEN_MT_MODEL="qwen-mt-turbo"

获取 API 密钥：

1. 访问 阿里云百炼控制台

2. 创建并获取 API Key

3. 确保账户有足够的调用额度

4. 启动服务器

# 直接运行
uv run python luhuo_qwen3_mt_mcp_server.py

快捷安装方式

方式一：使用 pip 安装

pip install luhuo_qwen3_mt_mcp_server

方式二：使用 uvx 安装（推荐）

uvx luhuo_qwen3_mt_mcp_server

客户端配置

在 mcp json 文件中添加以下配置：

{
  "mcpServers": {
    "luhuo_qwen3_mt_mcp_server": {
      "command": "uvx",
      "args": ["luhuo_qwen3_mt_mcp_server"],
      "env": {
        "DASHSCOPE_API_KEY": "your-dashscope-api-key-here"
      }
    }
  }
}

可用工具

1. translate_text_tool

文本翻译功能 - 将文本从源语言翻译到目标语言，支持术语干预和领域提示

Args:
    text: 需要翻译的文本
    target_lang: 目标语言，如"English", "Chinese"等
    source_lang: 源语言，默认为"auto"自动检测
    model: 使用的模型，默认使用环境变量配置的模型
    terminology: 术语词典，格式为 {"原术语": "目标术语"}
    domain: 领域提示，领域提示语句暂时只支持英文，如"The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."等

Returns:
    包含翻译结果或错误信息的字典

2. translate_text_streaming_tool

流式翻译功能 - 实时返回翻译结果，支持术语干预和领域提示

Args:
    text: 需要翻译的文本
    target_lang: 目标语言
    source_lang: 源语言，默认为"auto"
    model: 使用的模型
    terminology: 术语词典，格式为 {"原术语": "目标术语"}
    domain: 领域提示，领域提示语句暂时只支持英文，如"The sentence is from Ali Cloud IT domain. It mainly involves computer-related software development and usage methods, including many terms related to computer software and hardware. Pay attention to professional troubleshooting terminologies and sentence patterns when translating. Translate into this IT domain style."等

Returns:
    包含流式翻译结果的字典

使用示例

泰语翻译示例

我需要高质量的翻译请调用工具来执行，翻译下“我已经吃得很饱了”这句话为泰文

日语翻译示例

我已经吃得很饱了这句话用日文应该怎么说

支持的语言

本服务器支持 92 种语言，包括但不限于：

主要语言：

• 中文 (Chinese)
• 英语 (English)
• 日语 (Japanese)
• 韩语 (Korean)
• 法语 (French)
• 西班牙语 (Spanish)
• 德语 (German)
• 俄语 (Russian)
• 阿拉伯语 (Arabic)
• 葡萄牙语 (Portuguese)
• 意大利语 (Italian)
• 荷兰语 (Dutch)

亚洲语言：

• 泰语 (Thai)
• 印尼语 (Indonesian)
• 越南语 (Vietnamese)
• 印地语 (Hindi)
• 乌尔都语 (Urdu)
• 孟加拉语 (Bengali)
• 泰米尔语 (Tamil)
• 缅甸语 (Burmese)
• 高棉语 (Khmer)
• 老挝语 (Lao)
• 蒙古语 (Mongolian)

更多语言请参考服务器的 config://languages 资源。

故障排除

常见问题

1. 账户调用额度不足: 确保账户有足够的调用额度
2. 网络连接问题: 检查网络连接和防火墙设置
3. 模型不可用: 确认使用的模型名称正确

许可证

本项目采用 Apache-2.0 license 许可证。

致谢

• 感谢阿里云提供的通义千问翻译模型服务
• 感谢 FastMCP 框架的开发者们
• 感谢所有贡献者和用户的支持

注意： 使用本服务需要有效的阿里云百炼 API 密钥，请确保遵守相关服务条款和使用限制。