kaeris-mcp 0.2.0

MCP server for KAERIS i18n — AI-native localization for Claude Desktop, Cursor & agents

KAERIS i18n — MCP Server

AI-native localization over the Model Context Protocol. Give Claude Desktop, Cursor, Claude Code (or any MCP client) the ability to translate your app's strings into 46 languages — placeholder-safe, format-aware, incremental, with built-in Translation QA.

Tools

Tool	What it does	Calls the API?
kaeris_scan_repo	Discover a repo's i18n setup: locale files found, base language, target languages, framework guess (i18next/next-intl/vue-i18n/Flutter/Android/iOS/gettext/generic)	No
kaeris_status	Completeness/health per target locale — missing keys, extra keys, placeholder mismatches (same as kaeris check --json)	No
kaeris_list_missing_keys	The exact missing/broken keys (with source text) for one target locale, so an agent knows exactly what to fix	No
kaeris_list_languages	List all supported target languages	No
kaeris_translate	Translate inline strings → per-language results, with QA (placeholder-loss & UI-overflow flags; verify=True back-translates to check meaning)	Yes
kaeris_translate_file	Translate a file on disk (JSON/YAML/.strings/.po/ARB/XML/CSV), optional incremental	Yes
kaeris_add_language	Bootstrap a brand-new target locale by translating the whole source file into it	Yes

The first four tools are local-only (no network call, no cost) — an agent can use them freely to audit and understand a repo's i18n before deciding what (if anything) to translate.

Install

pip install kaeris-mcp

Configure your client

Claude Desktop — add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "kaeris-i18n": {
      "command": "kaeris-mcp",
      "env": {
        "KAERIS_API_KEY": "kaerisp_optional_for_pro_team"
      }
    }
  }
}

Cursor — Settings → MCP → Add, or .cursor/mcp.json:

{ "mcpServers": { "kaeris-i18n": { "command": "kaeris-mcp" } } }

Claude Code — one command:

claude mcp add kaeris-i18n kaeris-mcp

Restart the client; the KAERIS tools appear automatically.

Auth & tiers (all optional)

Env var	Purpose
KAERIS_API_KEY	Pro/Scale key — higher limits (else the free 10k-char tier is used)
KAERIS_OPENROUTER_KEY	OpenRouter key for Lifetime/BYOK — unlimited volume
KAERIS_API_URL	Override the API base URL

No key is required to try it — the free anonymous tier works out of the box.

Example prompts

• "Translate the strings in locales/en.json into German, Ukrainian and Japanese."
• "Add French and Spanish translations for these buttons: Save, Cancel, Delete."
• "Only translate the new keys I added to en.json — don't redo the whole file."
• "Check this repo's i18n and tell me what's missing or broken." (scans, then reports status — no API call)
• "We don't have Ukrainian yet — add it." (bootstraps a new locale via translation)

License

MIT