AI导哈

i18next翻译管理服务器

一个为i18next项目提供翻译管理功能的MCP服务器，支持AI助手直接与翻译文件交互。

  • by gtrias
  • TypeScript
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 gtrias/i18next-mcp-server

使用说明

i18next MCP服务器

一个模型上下文协议（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 -分析翻译质量

🔧 环境变量

变量 描述 默认值
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许可证-请参阅 许可证 了解详情。

🔗 链接

相关 MCP