返回市场
国际化MCP服务器

国际化MCP服务器

作者:gtrias10 星标更新:2025-06-27

项目介绍

i18next MCP 服务器

npm 版本 许可证: MIT

这是一个提供 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

🔗 链接