kaeris-mcp 0.1.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 42 languages — placeholder-safe, format-aware, incremental.

Tools

Tool	What it does
kaeris_list_languages	List all supported target languages
kaeris_translate	Translate inline strings — {"greeting":"Hello"} → per-language results
kaeris_translate_file	Translate a file on disk (JSON/YAML/.strings/.po/ARB/XML), optional incremental

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/Team 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."

License

MIT