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 CURSOR_SETUP.md.

📁 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

| Variable | Description | Default | |----------|-------------|---------| | I18N_PROJECT_ROOT | Your project root directory | Current directory | | I18N_LOCALES_PATH | Path to translation files | public/locales | | I18N_DEFAULT_LANGUAGE | Source language | en | | I18N_SUPPORTED_LANGUAGES | Comma-separated language codes | en |

🧪 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 LICENSE for details.

🔗 Links

• Setup Guide
• Contributing
• Issues