i18next MCP Server

i18next MCP Server

Um servidor Model Context Protocol (MCP) que fornece recursos de gerenciamento de tradução para projetos i18next, permitindo que assistentes de IA como o Cursor interajam diretamente com arquivos de tradução.

🚀 Configuração Rápida

A maneira mais fácil de usar este servidor MCP é com npx. Nenhuma instalação necessária:

npx i18next-mcp-server@latest --help

🔧 Configuração do Cursor

Adicione isto às suas configurações MCP do 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 instruções detalhadas de configuração, veja CURSOR_SETUP.md.

📁 Estrutura de Projeto Esperada

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

🛠️ Ferramentas Disponíveis

Ferramentas Principais

• get_project_info - Obter configuração e estatísticas do projeto
• health_check - Analisar a saúde e integridade dos arquivos de tradução
• scan_code_for_missing_keys - Encontrar chaves de tradução ausentes no seu código

Gerenciamento de Chaves

• add_translation_key - Adicionar novas chaves de tradução
• sync_missing_keys - Sincronizar chaves ausentes entre idiomas
• get_missing_keys - Listar chaves ausentes por idioma

Operações de Arquivo

• list_files - Listar todos os arquivos de tradução
• validate_files - Validar sintaxe JSON
• export_data - Exportar traduções para vários formatos

Análise

• coverage_report - Estatísticas de cobertura de tradução
• usage_analysis - Encontrar chaves de tradução não utilizadas
• quality_analysis - Analisar qualidade da tradução

🔧 Variáveis de Ambiente

Variável	Descrição	Padrão
I18N_PROJECT_ROOT	Diretório raiz do seu projeto	Diretório atual
I18N_LOCALES_PATH	Caminho para arquivos de tradução	public/locales
I18N_DEFAULT_LANGUAGE	Idioma de origem	en
I18N_SUPPORTED_LANGUAGES	Códigos de idioma separados por vírgula	en

🧪 Desenvolvimento

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

📝 Licença

Licença MIT - veja LICENSE para detalhes.

🔗 Links

• Guia de Configuração
• Contribuindo
• Problemas