📦

i18next-server

A comprehensive Model Context Protocol (MCP) server that provides automated translation management capabilities for Cursor and other AI assistants, enabling direct interaction with i18next translation files, health checking, missing key detection, and automated translation workflows.

0 installs

Trust: 42 — Fair

Devtools

Installation

npx i18next-mcp-server

Ask AI about i18next-server

I know everything about i18next-server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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.