I18next Mcp Server

Name: I18next Mcp Server
Author: gtrias

Local

github.com/gtriasDeveloper Tools12Updated 70w ago

Repository

About I18next Mcp Server

An MCP server for managing translation files in i18next projects, intended for AI assistants working with localization code. It combines key management, file validation, and coverage and usage analysis.

Key features

01Inspect project configuration and statistics
02Find and synchronize missing keys
03Add translation keys
04List and validate translation files
05Analyze coverage, usage, and quality
06Export translation data

Use cases

01Check translation completeness across locales
02Find missing keys referenced in code
03Validate localization JSON files
04Review unused keys and translation quality

MCP support

Exposes i18next project information, translation file operations, and localization analysis as tools for MCP clients.

#i18next #translations #l10n #mcp-server #ai-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "i18next": {
      "command": "npx",
      "args": [
        "-y",
        "i18next-mcp-server"
      ],
      "env": {
        "I18N_PROJECT_ROOT": "<I18N_PROJECT_ROOT>",
        "I18N_LOCALES_PATH": "<I18N_LOCALES_PATH>",
        "I18N_DEFAULT_LANGUAGE": "<I18N_DEFAULT_LANGUAGE>",
        "I18N_SUPPORTED_LANGUAGES": "<I18N_SUPPORTED_LANGUAGES>"
      }
    }
  }
}

Run commandnpx -y i18next-mcp-server

Environment variables to set

I18N_PROJECT_ROOT

I18N_LOCALES_PATH

I18N_DEFAULT_LANGUAGE

I18N_SUPPORTED_LANGUAGES

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmi18next-mcp-serverstdio

Tools

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.