i18next MCP Server

Un servidor MCP para gestionar traducciones en proyectos i18next, que permite a los asistentes de IA interactuar directamente con archivos de traducción.

GitHub
12
Prueba este MCPPatrocinado

Documentación

i18next MCP Server

npm version License: MIT

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de gestión de traducciones para proyectos i18next, permitiendo que asistentes de IA como Cursor interactúen directamente con los archivos de traducción.

🚀 Configuración rápida

La forma más fácil de usar este servidor MCP es con npx. No se requiere instalación:

npx i18next-mcp-server@latest --help

🔧 Configuración de Cursor

Añade esto a tu configuración de MCP de Cursor:

{
  "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"
      }
    }
  }
}

Para instrucciones detalladas de configuración, consulta CURSOR_SETUP.md.

📁 Estructura de proyecto esperada

your-project/
├── public/locales/          # Translation files
│   ├── en/
│   │   ├── common.json
│   │   └── navigation.json
│   ├── es/
│   │   ├── common.json
│   │   └── navigation.json
│   └── ...
└── src/                     # Your source code

🛠️ Herramientas disponibles

Herramientas principales

  • get_project_info - Obtener configuración y estadísticas del proyecto
  • health_check - Analizar la salud y completitud de los archivos de traducción
  • scan_code_for_missing_keys - Encontrar claves de traducción faltantes en tu código

Gestión de claves

  • add_translation_key - Añadir nuevas claves de traducción
  • sync_missing_keys - Sincronizar claves faltantes entre idiomas
  • get_missing_keys - Listar claves faltantes por idioma

Operaciones de archivos

  • list_files - Listar todos los archivos de traducción
  • validate_files - Validar sintaxis JSON
  • export_data - Exportar traducciones a varios formatos

Análisis

  • coverage_report - Estadísticas de cobertura de traducción
  • usage_analysis - Encontrar claves de traducción no utilizadas
  • quality_analysis - Analizar la calidad de la traducción

🔧 Variables de entorno

VariableDescripciónPredeterminado
I18N_PROJECT_ROOTDirectorio raíz de tu proyectoDirectorio actual
I18N_LOCALES_PATHRuta a los archivos de traducciónpublic/locales
I18N_DEFAULT_LANGUAGEIdioma de origenen
I18N_SUPPORTED_LANGUAGESCódigos de idioma separados por comasen

🧪 Desarrollo

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

📝 Licencia

Licencia MIT - consulta LICENSE para más detalles.

🔗 Enlaces