i18next MCP 服务器

这是一个提供 i18next 项目翻译管理能力的模型上下文协议 (MCP) 服务器，使像 Cursor 这样的AI助手可以直接与翻译文件交互。

🚀 快速设置

使用此 MCP 服务器最简单的方法是通过 npx。无需安装：

npx i18next-mcp-server@latest --help

🔧 Cursor 配置

在你的 Cursor MCP 设置中添加以下内容：

{
  "mcpServers": {
    "i18next-translation": {
      "command": "npx",
      "args": ["-y", "i18next-mcp-server@latest"],
      "env": {
        "I18N_PROJECT_ROOT": "/path/to/your/project",
        "I18N_LOCALES_PATH": "public/locales",
        "I18N_DEFAULT_LANGUAGE": "en",
        "I18N_SUPPORTED_LANGUAGES": "en,es,fr"
      }
    }
  }
}

有关详细的设置说明，请参阅 CURSOR_SETUP.md。

📁 预期项目结构

your-project/
├── public/locales/          # 翻译文件
│   ├── en/
│   │   ├── common.json
│   │   └── navigation.json
│   ├── es/
│   │   ├── common.json
│   │   └── navigation.json
│   └── ...
└── src/                     # 源代码

🛠️ 可用工具

核心工具

• get_project_info - 获取项目配置和统计信息
• health_check - 分析翻译文件的健康状况和完整性
• scan_code_for_missing_keys - 在代码中查找缺少的翻译键

键管理

• add_translation_key - 添加新的翻译键
• sync_missing_keys - 同步不同语言之间的缺失键
• get_missing_keys - 列出按语言分类的缺失键

文件操作

• list_files - 列出所有翻译文件
• validate_files - 验证 JSON 语法
• export_data - 导出翻译到各种格式

分析

• coverage_report - 翻译覆盖率统计
• usage_analysis - 查找未使用的翻译键
• quality_analysis - 分析翻译质量

🔧 环境变量

变量	描述	默认值
I18N_PROJECT_ROOT	项目根目录	当前目录
I18N_LOCALES_PATH	翻译文件路径	public/locales
I18N_DEFAULT_LANGUAGE	源语言	en
I18N_SUPPORTED_LANGUAGES	逗号分隔的语言代码	en

🧪 开发

git clone https://github.com/gtrias/i18next-mcp-server.git
cd i18next-mcp-server
npm install
npm run build
npm test

📝 许可证

MIT 许可证 - 详情见 LICENSE。

🔗 链接

• 设置指南
• 贡献指南
• 问题反馈