i18next MCP Server

★ 12

from gtrias

An MCP server for managing translations in i18next projects, allowing AI assistants to interact directly with translation files.

🔥🔥🔥✓ VerifiedFreeQuick setup

#git #translation

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.

📁 Expected Project Structure

Copy & paste — that's it

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

Copy & paste — that's it

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

Copy & paste — that's it

npx i18next-mcp-server@latest --help

Before it works, you'll need: I18N_PROJECT_ROOTI18N_LOCALES_PATHI18N_DEFAULT_LANGUAGEI18N_SUPPORTED_LANGUAGES

🚀 Quick Setup

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

Copy & paste — that's it

npx i18next-mcp-server@latest --help

🔧 Cursor Configuration

Add this to your Cursor MCP settings:

Copy & paste — that's it

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