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

🧪 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