I18next MCP Server

i18next MCP服务器

](https://badge.fury.io/js/i18next-mcp-server) 

一个模型上下文协议（MCP）服务器，为i18next项目提供翻译管理功能，使Cursor等人工智能助手能够直接与翻译文件交互。

🚀 快速设置

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

npx i18next-mcp-server@latest --help

🔧 光标配置

将此添加到光标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/          # Translation files
│   ├── en/
│   │   ├── common.json
│   │   └── navigation.json
│   ├── es/
│   │   ├── common.json
│   │   └── navigation.json
│   └── ...
└── src/                     # Your source code

🛠️ 可用工具

核心工具

• 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 -分析翻译质量

🔧 环境变量

🧪 发展

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

📝 许可证

MIT许可证-请参阅 许可证 了解详情。

🔗 链接

• 安装指南
• 贡献
• 问题