i18n-locale-mcp
Enables optional live translation of source strings into multiple target locales using an OpenAI-compatible API endpoint before running localization linting, with configurable base URL, API key, and model.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@i18n-locale-mcp lint my German translation for errors: Gesamt: 1,234 EUR"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
i18n-locale-mcp
A zero-dependency MCP server that gives any AI agent a localization QA toolkit. Deterministic, offline-capable, and safe to run in CI.
Works with Claude Desktop, Cursor, Dify, AutoGPT, and any MCP-compatible client.
Why
Shipping a product in 20 locales is easy; shipping it correctly is not. Agents and devs
constantly produce 1,234 in German, 03/25 in French, missing {name} placeholders, or
untranslated brand terms. This server catches those deterministically — no API key needed.
Related MCP server: kaeris-mcp
Tools
Tool | What it does | Network |
| Locale formatting rules (quotes, separators, dates, RTL, formality) for 20 locales | none |
| Accented + expanded pseudolocale to catch hard-coded strings & truncation | none |
| Number/date separators, quote style, CJK punctuation, RTL bidi, placeholder parity, length budget | none |
| Enforce terminology + protect brand terms across targets | none |
| Translate to N locales, then lint — or emit structured translation jobs if no provider is set | optional |
localize never fabricates translations: without a provider configured it returns
machine-readable translation jobs (source + rules + placeholders) for you to execute.
Install
git clone <repo> && cd i18n-mcp
node index.js --list-tools # sanity check
node test/smoke.mjs # 11 deterministic checksRequires Node.js >= 18. No dependencies.
Use with an MCP client
Add to claude_desktop_config.json (or Cursor / Dify MCP settings):
{
"mcpServers": {
"i18n": {
"command": "node",
"args": ["/absolute/path/to/i18n-mcp/index.js"]
}
}
}Optional: enable live translation
Set an OpenAI-compatible endpoint and localize will translate before linting:
export I18N_LLM_BASE_URL="https://api.openai.com/v1"
export I18N_LLM_API_KEY="sk-..."
export I18N_LLM_MODEL="gpt-4o-mini" # optionalWithout these, localize returns providerMode: "jobs" and does zero network calls.
Examples
Pseudolocalize (find hard-coded UI strings)
pseudoLocalize("Save changes") // 【Såvé çhångéš~~~~~~~~~】Lint a translation
{ "text": "Gesamt: 1,234 EUR", "locale": "de-DE" }→ NUMBER_GROUP_SEP error: German expects . as thousands separator.
Programmatic API
import { pseudoLocalize, lint, glossaryApply, localize } from "i18n-locale-mcp";
lint("Cherchez 03/25/2026", "fr-FR"); // DATE_ORDER error
glossaryApply([{ source: "Save", target: "Enregistrer" }],
[{ key: "btn.save", text: "Save" }]); // TERM_UNTRANSLATED
await localize("Hello {name}", ["de-DE", "ja-JP"]); // lint-ready outputCLI
node index.js # run MCP server on stdio
node index.js --list-tools # list tools
node index.js --versionLicense
MIT
Available Tools
5 toolsglossary_applyB
Enforce glossary/term consistency across target strings. Flags untranslated source terms and brand-term variants. Deterministic.
Inputs: items (required), glossary (required).
i18n_lintA
Lint a translated string against a locale's rules: number/date separators, quote style, CJK fullwidth punctuation, RTL bidi marks, placeholder parity with source, and length budget. Deterministic.
Inputs: text (required), locale (required), source, maxLength.
list_localesA
List supported locales and their formatting rules (quotes, separators, date format, RTL, formality).
Inputs: no named parameters.
localizeA
Translate source text into one or more locales and post-process (lint + glossary). With an OpenAI-compatible provider configured it returns real translations; otherwise it returns structured translation jobs (it never fabricates output).
Inputs: text (required), locales (required), glossary, maxLength.
pseudo_localizeA
Generate pseudolocalized text (accented + expanded + bracketed) to catch hard-coded strings, truncation and layout breakage before real translation. Deterministic; safe for CI.
Inputs: text (required), accent, brackets, expansion.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct primary purpose, but localize overlaps slightly with i18n_lint and glossary_apply because it performs post-processing. The descriptions clarify when to use each, so confusion is limited.
All names use snake_case, which is consistent, but the structural pattern varies: list_locales and pseudo_localize are verb-like, i18n_lint and glossary_apply are noun-first, and localize is a bare verb. This is mostly predictable with minor deviations.
Five tools is well-scoped for a focused i18n localization toolkit. Each tool earns its place by covering a specific stage of the localization workflow.
The surface covers locale inspection, pseudolocalization, linting, glossary enforcement, and translation, which is strong lifecycle coverage. Minor gaps exist around configuring translation providers or extracting strings from source files, but agents can work around these.
Related MCP Connectors
Agentic localization for documents and media, with quality checks and optional human review.
AI-native translation management: push translation files, translate, review and audit strings.
Localize apps from your AI assistant: translate locale files, set glossaries, connect GitHub repos.
Localize apps from your AI agent: create projects, add languages, import files, add strings, export.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAI-powered translation management built for AI agents. Automate localization with regional sensitivity and zero TMS overhead. Works with Claude Code, Cursor, VS Code via MCP protocol. Supports JSON, YAML, Markdown, PO and more.MIT
- AlicenseAqualityBmaintenanceAI localization from your editor — translate an app's string files into 46 languages with placeholder-safe, reproducible output. Eleven formats (JSON, .arb, .po, .strings, Android XML and more), and every translation is read back and checked before it lands.7119 PyPIMIT
- AlicenseAqualityBmaintenanceTranslation QA for i18n locale files. Deterministic validators — missing keys, placeholder drift, collapsed plurals, glossary breaches — that need no API key, plus a review tool that hands translation pairs and judging criteria back to the calling agent, so meaning-level review runs on the model your client already has. Translation with your own LLM key is optional. JSON, Flutter .arb, Apple .8Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables deterministic linting of locale files across JSON, Laravel PHP, gettext, and YAML, with no LLM or network, verifying translations for missing keys, placeholders, plural forms, glossary consistency, and stale entries.5 npmMIT