article
README
🚀 🌐 i18n MCP 服务器
i18n MCP 服务器是一款功能强大的工具,用于管理项目中的国际化(i18n)。它将强大的语言模型集成到便捷的服务器界面中,简化了从单个基础语言文件生成 JSON 基础语言文件的翻译流程。
🚀 快速开始
该 MCP 服务器专为与 Cursor IDE 使用 stdio 传输一起工作而设计,也能与其他支持 stdio 传输的客户端正常协作。
✨ 主要特性
💡 为何选择 i18n MCP 服务器?
- 节省数小时的手动翻译工作。
- 确保您的 i18n 文件一致且最新。
- 消除在全球范围内扩展应用程序时重复的复制/粘贴任务。
🌍 多语言支持
可从单个基础语言文件自动生成多种语言的翻译。
🤖 使用 Cursor 中的语言模型进行翻译
无需额外支付翻译服务费用。您可以选择要使用的翻译模型,并按需生成翻译。
⚡ 无痛工作流程
无需手动复制或编辑 JSON 文件,只需发送请求,即可立即获得准备好的翻译文件。
🛠️ 开发者友好
构建简单快速,可无缝集成到开发流水线中。
📚 详细文档
工作流程
此 MCP 服务器有助于逐步管理 JSON 文件的翻译。它提供了一些简单的工具来:
- 获取包含所有文本在一个语言以及支持的语言集合的基础语言文件。
- 获取要翻译的文本块。每个块将是一行分隔的文本列表。
- 更新生成的翻译到内存缓存中。
- 将翻译保存到特定语言的 JSON 文件中。
📦 安装指南
- 克隆仓库
git clone
- 安装依赖项:
pnpm install # 或 npm/yarn
- 构建服务器:
pnpm run build
- 在 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 直到所有字符串都被翻译。
⚠️ 注意事项
⚠️ 重要提示
- 确保您的系统已安装 Node.js 和 PNPM。
- 在运行服务器之前,请确保所有依赖项都已正确安装。
- 如果您遇到任何问题,请检查网络连接,因为某些 API 调用可能需要互联网访问。
希望这些说明对您有帮助!如果有任何其他问题,请随时与我们联系。
扫码联系在线客服