i18next-mcp-server

gtrias/i18next-mcp-server

3.4

If you are the rightful owner of i18next-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The i18next MCP Server is a Model Context Protocol server designed to manage translations for i18next projects, facilitating direct interaction with translation files by AI assistants like Cursor.

i18next MCP Server

A Model Context Protocol (MCP) server that provides translation management capabilities for i18next projects, enabling AI assistants like Cursor to directly interact with translation files.

๐Ÿš€ Quick Setup

The easiest way to use this MCP server is with npx. No installation required:

npx i18next-mcp-server@latest --help

๐Ÿ”ง Cursor Configuration

Add this to your Cursor MCP settings:

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

For detailed setup instructions, see .

๐Ÿ“ Expected Project Structure

your-project/
โ”œโ”€โ”€ public/locales/          # Translation files
โ”‚   โ”œโ”€โ”€ en/
โ”‚   โ”‚   โ”œโ”€โ”€ common.json
โ”‚   โ”‚   โ””โ”€โ”€ navigation.json
โ”‚   โ”œโ”€โ”€ es/
โ”‚   โ”‚   โ”œโ”€โ”€ common.json
โ”‚   โ”‚   โ””โ”€โ”€ navigation.json
โ”‚   โ””โ”€โ”€ ...
โ””โ”€โ”€ src/                     # Your source code

๐Ÿ› ๏ธ Available Tools

Core Tools

  • get_project_info - Get project configuration and statistics
  • health_check - Analyze translation file health and completeness
  • scan_code_for_missing_keys - Find missing translation keys in your code

Key Management

  • add_translation_key - Add new translation keys
  • sync_missing_keys - Sync missing keys between languages
  • get_missing_keys - List missing keys by language

File Operations

  • list_files - List all translation files
  • validate_files - Validate JSON syntax
  • export_data - Export translations to various formats

Analysis

  • coverage_report - Translation coverage statistics
  • usage_analysis - Find unused translation keys
  • quality_analysis - Analyze translation quality

๐Ÿ”ง Environment Variables

VariableDescriptionDefault
I18N_PROJECT_ROOTYour project root directoryCurrent directory
I18N_LOCALES_PATHPath to translation filespublic/locales
I18N_DEFAULT_LANGUAGESource languageen
I18N_SUPPORTED_LANGUAGESComma-separated language codesen

๐Ÿงช Development

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

๐Ÿ“ License

MIT License - see for details.

๐Ÿ”— Links