@rog0x/mcp-i18n-tools

Internationalization and localization tools for AI agents, exposed as an MCP (Model Context Protocol) server.

Tools

detect_locale

Detect the language and locale of a given text string. Returns the detected language code (BCP 47), language name, writing script, confidence score (0-1), and alternate language candidates.

Supported languages: English, Spanish, French, German, Portuguese, Italian, Russian, Japanese, Korean, Chinese, Arabic, Hindi, Thai, Greek, Hebrew.

extract_i18n_keys

Extract hardcoded user-facing strings from source code that should be internationalized. Finds strings in:

• JSX/TSX attributes (title, placeholder, label, alt, aria-label, etc.)
• HTML template text and attributes
• console.log / console.warn / console.error calls
• throw new Error(...) messages
• alert() / confirm() / prompt() dialogs
• Variable assignments with i18n-relevant names (message, label, title, etc.)

Returns each string with its line/column, surrounding context, pattern type, and a suggested i18n key.

analyze_translations

Analyze translation JSON files for consistency across locales. Detects:

• Missing keys — present in reference locale but absent in others
• Extra keys — present in a locale but not in the reference
• Structure mismatches — a key is a string in one locale but an object in another
• Interpolation mismatches — {variable} placeholders differ between locales
• Empty values — keys with blank translations
• Unused keys — keys not referenced in source code (requires a list of used keys)

plural_rules

Generate plural form categories for a given locale following CLDR rules. Shows which plural categories the language uses and classifies any test numbers you provide.

Language	Categories
English	one, other
French	one, other
Russian	one, few, many, other
Arabic	zero, one, two, few, many, other
Polish	one, few, many, other
Japanese	other
Chinese	other

format_locale

Format numbers, currencies, dates, and relative times for any locale using the Intl APIs. Supports:

• Numbers — decimal, percent, unit; compact/scientific/engineering notation
• Currency — symbol, narrowSymbol, code, and name displays
• Dates — short, medium, long, full styles with date parts breakdown
• Relative time — long, short, narrow styles with auto-numeric formatting

Setup

npm install
npm run build

MCP Configuration

{
  "mcpServers": {
    "i18n-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-i18n-tools/dist/index.js"]
    }
  }
}

License

MIT