🌐 i18n MCP 服务器

i18n MCP 服务器是一款强大的工具，用于管理项目中的国际化(i18n)。它通过允许您使用强大的语言模型从基础语言文件生成翻译，简化了基于JSON的语言文件的翻译过程——这一切都通过一个方便的服务器界面完成。

MCP服务器旨在与Cursor IDE配合使用，采用stdio传输方式。它也应该能够与支持stdio传输的任何客户端正常工作。

💡 为什么选择 i18n MCP 服务器？

• 节省数小时的手动翻译工作
• 保持您的i18n文件一致且最新
• 在全球扩展应用时消除重复的复制/粘贴任务。

🚀 功能

🌍 多语言支持

自动从单一基础语言文件生成多种语言的翻译。

🤖 使用Cursor上的模型进行翻译

您无需支付额外的翻译服务费用。选择您想要使用的翻译模型，并按需生成翻译。

⚡ 无缝工作流程

无需手动复制或编辑JSON文件——只需发送请求，即可获得准备好的翻译文件。

🛠️ 开发者友好

以简单性和速度构建，以便无缝集成到开发管道中。

工作流程

此MCP服务器帮助逐步翻译JSON文件。它提供了简单的工具来：

1. 获取包含所有文本的基础语言文件以及支持的语言集。
2. 获取要翻译的字符串片段。每个片段将是一系列由换行符分隔的文本。
3. 更新内存缓存中的生成翻译。
4. 将翻译保存到特定语言的JSON文件中。

📦 安装和配置

1. 克隆仓库

git clone

2. 安装依赖项：

pnpm install # 或 npm/yarn

3. 构建服务器：

pnpm run build

4. 在Cursor上配置MCP服务器

导航至Cursor设置 / MCP并点击添加新的MCP服务器。在打开的JSON中，包括服务器定义：

{
  "mcpServers": {
    ...
    "i18n-translation-server": {
      "command": "node",
      "args": ["<base-path>/i18n-mcp/dist/mcp_server.js"]
    },
    ...
  }
}

您需要将<base-path>替换为编译服务器的正确绝对路径。

📤 使用方法

一旦MCP服务器运行起来，您可以使用Cursor代理与服务器工具交互。例如：

我们正在为一个项目准备i18n文件，并有一个基础语言文件。使用以下数据执行提议的任务，准备所需的附加语言。

基础JSON语言文件： <基础语言文件的绝对路径>
基础语言： <基础语言>
支持的语言： <逗号分隔的支持语言列表>

我们需要执行以下任务：

1. 清除之前的记录
2. 读取基础JSON语言文件
3. 获取下一个片段
4. 对于支持语言中的每种语言，执行以下子任务：
   4.1. 将片段中的所有项目从基础语言翻译为目标语言。确保顺序保持不变，并尊重任何i18n字符串参数。
   4.2. 更新该语言的翻译
5. 从任务3开始重复，直到下一个片段不返回任何数据。
6. 在处理完所有片段后，为每种支持的语言保存翻译。

此请求将在基础JSON语言文件所在的同一文件夹中为每种语言生成一个JSON文件。当前版本已使用gpt-4.1和大小为250条目的片段进行了测试。对于其他模型，可能需要根据令牌限制调整此值。另一个可能出现的问题是，在步骤5和6之间，流程有时会被中断，由于Cursor中的25个工具调用限制，这需要手动恢复。

这只是提议的任务请求，但可以通过链接定义的工具编写新的请求。

在测试过程中，我们注意到当每次请求只生成一种语言时，语言文件生成得更快，而不是一次性生成所有语言。此外，响应时间将取决于所使用的模型。

📚 未来计划

• 支持多个缓存
• 语言文件完整性检查
• 支持动态片段大小
• 仅翻译缺失的条目
• 仅翻译特定项目
• 语言文件版本跟踪
• 更好的本地翻译缓存

🙌 贡献

欢迎提交拉取请求和问题！让我们一起建立更好的翻译工作流程。

📄 许可证

本项目根据GNU Affero通用公共许可证v3.0授权。详情见LICENSE文件。