Nuxt I18n MCP Server

the-i18n-kit

Toolkit for managing i18n translation files — read, write, search, rename, and remove translation keys across all locales and layers. Supports Nuxt, Laravel, and any project with JSON or PHP locale files.

Packages

CLI

npm install -g the-i18n-cli

the-i18n-cli detect                    # Auto-detect project config
the-i18n-cli missing                   # Find missing translations
the-i18n-cli search --query "save"     # Search keys and values
the-i18n-cli cleanup                   # Find orphan keys (dry-run by default)

→ Full CLI documentation

MCP Server

Add to your MCP host (VS Code, Cursor, Claude Desktop, Zed):

{
  "servers": {
    "the-i18n-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["the-i18n-mcp@latest"]
    }
  }
}

→ Full MCP documentation

Supported Frameworks

Project Config

Drop a .i18n-mcp.json at your project root for project-specific context:

{
  "$schema": "node_modules/the-i18n-mcp/schema.json",
  "context": "B2B SaaS booking platform",
  "glossary": {
    "Booking": "Core concept. Dutch: 'Boeking'.",
    "Resource": "A bookable entity (room, desk, person)"
  },
  "translationPrompt": "Professional but approachable tone. Keep translations concise.",
  "localeNotes": {
    "de": "Informal German (du)",
    "de-formal": "Formal German (Sie)"
  }
}

How Orphan Detection Works

The scanner finds translation key references in source code:

Nuxt/Vue patterns: $t('key'), t('key'), $tc('key'), i18n.t('key'), v-t="'key'", template literals with $t

Laravel/PHP patterns: __('key'), trans('key'), @lang('key'), Lang::get('key'), trans_choice('key')

Dynamic key handling:

• Template literals like $t(`status.${val}`) → the scanner extracts status. as a prefix and matches all keys under status.*
• Keys matching dynamic prefixes are excluded from orphan results (reported as "uncertain" separately)
• String concatenation ('prefix.' + var) is not detected — use template literals for coverage

Monorepo scope:

• Each layer's keys are scanned only against source files that consume that layer
• Layer consumption is determined by the framework's layer/dependency graph

Development

pnpm install        # Install all dependencies
pnpm build          # Build all packages
pnpm test           # Run all tests
pnpm lint           # ESLint across all packages
pnpm typecheck      # TypeScript check all packages

Set DEBUG=1 to enable verbose logging to stderr.

Roadmap

• find_hardcoded_strings — detect user-facing strings not wrapped in translation calls
• move_translations — move keys between layers
• Glossary validation — check translations against glossary terms
• Flat JSON support — flatJson: true in vue-i18n config
• Pluralization support — vue-i18n plural forms and Laravel trans_choice

License

MIT