I18n MCP Server

🚀 🌐 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 Settings / MCP 并点击以添加新的 MCP 服务器。在打开的 JSON 中，包括服务器定义：

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

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

📤 使用示例

基础用法

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

我们在准备一个项目的 i18n 文件，并且有一个基础语言文件。使用以下数据，执行拟议的任务以准备所需的其他语言。

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

我们需要执行以下任务：

1. 清除以前的数据
2. 读取基础语言文件
3. 获取所有需要翻译的字符串
4. 将每个字符串发送到翻译 API 进行翻译
5. 将翻译结果保存到对应的目标语言文件中

重复步骤 3 - 5 直到所有字符串都被翻译。

⚠️ 注意事项

⚠️ 重要提示

1. 确保您的系统已安装 Node.js 和 PNPM。
2. 在运行服务器之前，请确保所有依赖项都已正确安装。
3. 如果您遇到任何问题，请检查网络连接，因为某些 API 调用可能需要互联网访问。

希望这些说明对您有帮助！如果有任何其他问题，请随时与我们联系。