MCP i18n Page Translator

基于 MCP (Model Context Protocol) 的页面级 i18n 翻译服务，使用阿里云百炼 Qwen 模型进行翻译。

功能特性

• 按页面名称翻译，自动处理目录结构
• 支持 TypeScript 文件格式 (export default {})
• 内置术语表，保持专业术语翻译一致性
• 增量翻译，只翻译新增或修改的内容
• 默认翻译到 4 种语言：中文、日语、法语、德语

安装

npm install
npm run build

配置

1. 获取阿里云百炼 API Key

访问 阿里云百炼控制台 创建 API Key。

2. 配置环境变量

cp .env.example .env
# 编辑 .env 文件，填入 DASHSCOPE_API_KEY

3. 配置 Claude Desktop

编辑配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "i18n-translator": {
      "command": "node",
      "args": ["/path/to/mcp-i18n/dist/index.js"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key"
      }
    }
  }
}

使用方法

在 Claude 对话中说：

i18n翻译mockupA页面，basePath是/packages/web/src/locale

目录结构

源文件位置：

{basePath}/{pageName}/en-US/
├── index.ts
└── other.ts

生成的翻译文件：

{basePath}/{pageName}/
├── en-US/
│   └── index.ts          # 源文件
├── zh-CN/
│   └── index.ts          # 中文翻译
├── ja-JP/
│   └── index.ts          # 日语翻译
├── fr-FR/
│   └── index.ts          # 法语翻译
└── de-DE/
    └── index.ts          # 德语翻译

文件格式

源文件必须使用 export default 导出对象：

// en-US/index.ts
export default {
  title: "Welcome to Pacdora",
  description: "Create your custom packaging",
  buttons: {
    save: "Save",
    cancel: "Cancel"
  }
};

生成的翻译文件：

// zh-CN/index.ts
export default {
  title: "欢迎使用 Pacdora",
  description: "创建您的定制包装",
  buttons: {
    save: "保存",
    cancel: "取消"
  }
};

工具参数

参数	必填	默认值	说明
pageName	是	-	页面名称，如 mockupA
basePath	是	-	locale 目录的基础路径
sourceLocale	否	en-US	源语言代码
targetLocales	否	["zh-CN", "ja-JP", "fr-FR", "de-DE"]	目标语言列表
model	否	qwen-turbo	Qwen 模型
incremental	否	true	是否增量翻译

术语表

内置术语表确保专业术语翻译一致：

术语	zh-CN	ja-JP	fr-FR	de-DE
Pacdora	Pacdora	Pacdora	Pacdora	Pacdora
Dieline	刀板	テンプレート	Gabarit	Stanzlinie

修改 src/glossary.ts 可自定义术语表。

支持的模型

模型	特点
qwen-turbo	平衡性能和成本（默认）
qwen-plus	更高质量
qwen-max	最高质量
qwen-flash	极速响应

项目结构

mcp-i18n/
├── src/
│   ├── index.ts        # MCP 服务器入口
│   ├── scanner.ts      # 目录扫描和 TS 文件解析
│   ├── translator.ts   # Qwen API 翻译引擎
│   ├── generator.ts    # 翻译文件生成器
│   └── glossary.ts     # 术语表
├── dist/               # 编译输出
└── package.json

开发

npm run dev    # 监听模式编译
npm run build  # 编译
npm start      # 运行服务

许可证

MIT