L10n.dev - AI Localization Agent

El Agente de Localización con IA añade localización profesional. En lugar de cargar archivos i18n grandes en el contexto de la IA, los traduce del lado del servidor mediante MCP (el paquete ai-l10n-mcp, construido sobre el SDK y CLI de ai-l10n), ahorrando tokens y manteniendo al agente enfocado en la codificación. Preserva formatos de archivo, marcadores de posición y traducciones existentes, admite 165 idiomas, aplica glosarios persistentes e instrucciones lingüísticas personalizadas, y traduce solo las cadenas modificadas para una localización rápida y lista para producción.

GitHub

Prueba este MCPPatrocinado

Documentación

ai-l10n-mcp

Servidor MCP que brinda a los agentes de IA acceso a l10n.dev — un servicio profesional de localización diseñado específicamente para archivos de i18n de software.

Cuando un agente de IA necesita traducir tu aplicación, el enfoque ingenuo es pegar el contenido del archivo en el chat. Eso falla rápidamente: los archivos de localización son grandes, los formatos son estrictos, los marcadores de posición deben sobrevivir textualmente, los glosarios se desvían entre sesiones y el agente no tiene memoria entre ejecuciones. Este MCP reemplaza ese flujo de trabajo frágil con un motor de localización dedicado que el agente invoca como herramienta — obteniendo resultados de nivel profesional sin desperdiciar la ventana de contexto en el contenido bruto de los archivos.

Piénsalo como darle a tu agente de IA un copiloto profesional de localización: el agente maneja la intención y la orquestación; l10n.dev maneja la traducción real con precisión, consistencia y garantías de formato.

¿Por qué usar esto en lugar de preguntarle directamente a tu agente de IA?

	Solo agente de IA	ai-l10n-mcp
Soporte de 165 idiomas	Varía, a menudo limitado	✅ Cobertura completa
Manejo de archivos grandes	Trunca u omite	✅ Manejo completo en el servidor
Preservación de formato	Frágil — rompe marcadores, claves, estructura	✅ Garantizado — el formato fuente se valida después de la traducción
Consistencia del glosario	Se pierde entre sesiones y fragmentos de archivos	✅ Glosario persistente aplicado en todos los archivos y fragmentos
¿Requiere post-edición?	Generalmente sí	✅ No — el resultado está listo para producción
Costo de tokens	Alto — archivo bruto en contexto	✅ Bajo — solo se devuelven metadatos
Actualizaciones incrementales	Lectura completa y retraducción cada vez	✅ Solo cadenas nuevas/cambiadas

Características

165 idiomas — traduce a toda la gama de idiomas del mundo en una sola llamada
Formato garantizado — JSON, JSONC, Flutter ARB, YAML, PO (gettext), XLIFF, MD y todos los formatos de i18n basados en texto; los marcadores de posición, claves y estructura se preservan y validan después de la traducción
Detección automática de idiomas de destino a partir de la estructura del proyecto
Glosario persistente — genera un glosario desde tu contenido, guárdalo y haz que se aplique automáticamente en cada archivo y fragmento posterior para una terminología consistente
Instrucciones lingüísticas — guarda reglas de estilo/tono por par de idiomas (por ejemplo, "Usa tono formal")
Traducción incremental — la detección de cambios basada en hash omite cadenas ya traducidas, ahorrando cuota y protegiendo traducciones existentes
Control de calidad proactivo — verifica instrucciones y glosario para cada par de idiomas antes de traducir, no después

Conecta Claude Desktop, Cursor, Windsurf, GitHub Copilot, OpenAI Codex o cualquier agente compatible con MCP directamente al motor de traducción de l10n.dev.

Instalación y configuración

Obtener una clave de API

Crea una cuenta gratuita y obtén tu clave de API en https://l10n.dev/ws/api-keys

Consejo: En lugar de configurar L10N_API_KEY en cada configuración, puedes pedirle a la IA que guarde tu clave con l10n_set_api_key. La clave se guarda en ~/.ai-l10n/config.json y se usa automáticamente.

Claude Desktop

En Claude Desktop, abre Configuración > Desarrollador > Editar configuración. Claude Desktop abrirá el archivo de configuración MCP correcto para tu instalación. En macOS, normalmente es ~/Library/Application Support/Claude/claude_desktop_config.json. En Windows, la ruta de respaldo puede variar según la instalación, así que prefiere Editar configuración en lugar de navegar manualmente. Añade:

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Abre Personalizar en Cursor para añadir y gestionar servidores MCP. Para una configuración basada en archivos, crea una de estas configuraciones:

~/.cursor/mcp.json para una configuración a nivel de usuario
.cursor/mcp.json en tu proyecto para una configuración específica del espacio de trabajo

Añade:

{
  "mcpServers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf

En Windsurf, abre el panel MCPs en Cascade, o ve a Configuración de Devin > Cascade > Servidores MCP. Si necesitas añadirlo manualmente, edita ~/.codeium/windsurf/mcp_config.json y añade:

{
  "mcpServers": {
    "l10n": {
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

GitHub Copilot (VS Code)

Abre la Paleta de comandos y selecciona MCP: Abrir configuración de usuario. Alternativamente, crea un archivo .vscode/mcp.json en tu espacio de trabajo o en la configuración de usuario. Añade:

{
  "servers": {
    "l10n": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ai-l10n-mcp"],
      "env": {
        "L10N_API_KEY": "your-api-key-here"
      }
    }
  }
}

OpenAI Codex (CLI e IDE)

Añade a ~/.codex/config.toml para una configuración a nivel de usuario, o .codex/config.toml en un proyecto de confianza:

[mcp_servers.l10n]
command = "npx"
args = ["-y", "ai-l10n-mcp"]

[mcp_servers.l10n.env]
L10N_API_KEY = "your-api-key-here"

También puedes añadirlo desde la terminal:

codex mcp add l10n --env L10N_API_KEY=your-api-key-here -- npx -y ai-l10n-mcp

Claude Code (CLI y extensión de VS Code)

Añade el servidor desde la terminal:

claude mcp add --env L10N_API_KEY=your-api-key-here --transport stdio l10n -- npx -y ai-l10n-mcp

Para una configuración compartida de proyecto, Claude Code también puede almacenar servidores MCP en un archivo .mcp.json en la raíz de tu proyecto.

Herramientas disponibles

Traducción

Herramienta	Descripción
`l10n_translate_file`	Traduce un archivo fuente de i18n a uno o más idiomas de destino
`l10n_detect_project_structure`	Escanea un archivo fuente para detectar el tipo de estructura, idioma fuente, idiomas de destino y rutas de archivos de destino

Ambas herramientas detectan códigos de idioma en carpetas de códigos de idioma (locales/en/common.json, reportados como folder-based) y en nombres de archivo (file-based) — ya sea que el nombre sea el código en sí (locales/en.json) o lo contenga junto con otras partes (app_en.arb, locales/emails.en.json, locales/en-US.common.json, messages_en_US.properties). Para convenciones de nomenclatura que no se reconozcan, pasa languageCodeRegex, una expresión regular que contenga un grupo (?<language>...), por ejemplo ^emails\.(?<language>[\w-]+)\.json$. El texto alrededor del grupo se reutiliza para los archivos de destino, por lo que emails.en.json produce emails.ru-RU.json.

Instrucciones lingüísticas

Herramienta	Descripción
`l10n_list_instructions`	Lista todas las instrucciones lingüísticas guardadas (tono, estilo, voz de marca)
`l10n_create_instruction`	Crea una nueva instrucción para un par de idiomas
`l10n_update_instruction`	Actualiza una instrucción existente
`l10n_delete_instruction`	Elimina una instrucción

Glosario

Herramienta	Descripción
`l10n_list_glossaries`	Lista todos los glosarios guardados
`l10n_get_glossary`	Obtiene detalles completos y entradas de un glosario específico
`l10n_create_glossary`	Crea un nuevo glosario vacío
`l10n_update_glossary`	Actualiza el nombre o estado activo del glosario
`l10n_delete_glossary`	Elimina permanentemente un glosario
`l10n_add_glossary_entry`	Añade una asignación de término a un glosario
`l10n_delete_glossary_entry`	Elimina una asignación de término de un glosario

Cuenta

Herramienta	Descripción
`l10n_get_balance`	Verifica el saldo de caracteres restante
`l10n_set_api_key`	Almacena una clave de API localmente para uso automático
`l10n_get_api_key_status`	Verifica si una clave de API está configurada

Prompts disponibles

`l10n_project_setup`

Guía a través de la verificación y configuración de instrucciones lingüísticas y glosarios para una calidad de traducción óptima. Invócalo al inicio de un nuevo proyecto o al revisar la configuración de l10n.dev.

Argumentos:

sourceLanguage — código de idioma fuente (predeterminado: en)
targetLanguages — códigos de idiomas de destino separados por comas (por ejemplo, es,fr,de)

`l10n_setup_automation`

Escanea el proyecto en busca de archivos fuente de i18n (usando l10n_detect_project_structure), verifica instrucciones lingüísticas, glosario y saldo, luego configura interactivamente la traducción totalmente automatizada mediante GitHub Actions o scripts de npm.

Para GitHub Actions, guía a través de cuatro opciones de activación:

A) En cada push a main — traduce y haz commit de vuelta directamente
B) En pull requests — traduce y abre un PR para revisión
C) En un horario — traduce nocturnamente o en un cron
D) Solo activación manual — workflow_dispatch

Escribe ai-l10n.config.json y .github/workflows/translate.yml (o actualiza los scripts de package.json), luego te indica dónde añadir la clave de API y qué sucede en la siguiente activación.

Argumentos:

sourceLanguage — código de idioma fuente (predeterminado: en)
targetLanguages — códigos de idiomas de destino separados por comas (por ejemplo, es,fr,de)

Flujo de trabajo de ejemplo

Usuario: "Traduce mi aplicación al español y francés"

Claude (con este servidor MCP) hará:

Llamar a l10n_list_instructions — no encuentra instrucción para los pares de idiomas es/fr
Preguntar: "No se encontró instrucción para español/francés — ¿te gustaría establecer una regla de tono/estilo antes de traducir? (por ejemplo, formal, casual, mantener términos de marca sin traducir)"
El usuario dice: "El tono debe ser informal, es para una aplicación de comida en América Latina"
Llamar a l10n_create_instruction con la regla de estilo
Llamar a l10n_list_glossaries — no encuentra glosario activo para es/fr
Preguntar: "No se encontró glosario para español/francés — ¿habilitar la generación de glosario para esta ejecución? Guarda términos clave para traducciones futuras consistentes."
El usuario dice: "Sí"
Detectar que es.json y fr.json ya existen — preguntar: "Los archivos de destino ya existen — ¿habilitar el modo incremental para omitir cadenas sin cambios y ahorrar cuota?"
El usuario dice: "Sí"
Llamar a l10n_translate_file con sourceFile, targetLanguages: ["es", "fr"], instruction, generateGlossary: true, translateOnlyNewStrings: true
Reportar resultados

Traducción incremental

Para formatos basados en JSON, habilita translateOnlyNewStrings: true para omitir cadenas que ya están traducidas. Se almacena un hash de cada cadena fuente (no el contenido en sí) en el servidor de l10n.dev para la detección de cambios — solo se traducen cadenas añadidas o cambiadas, ahorrando tu cuota de caracteres.

Nota: En la primera traducción solo se traducen cadenas añadidas, porque la tabla de hash está vacía para detectar cadenas cambiadas.

Automatización: CLI y GitHub Actions

Para automatización de CI/CD y uso desde línea de comandos, consulta:

CLI de ai-l10n — traduce archivos desde la terminal o pipelines de CI
GitHub Action — auto-traducción en push, PR o activación manual

Precios

Nivel gratuito — 10,000 caracteres gratis cada mes, sin necesidad de tarjeta de crédito.
Pago por uso — Precios asequibles basados en caracteres sin suscripción requerida.
Paquetes actuales — Visita l10n.dev/#pricing para precios actualizados.

Privacidad y seguridad

Sin retención de datos — El texto fuente y las traducciones no se almacenan en los servidores de l10n.dev más allá del tiempo necesario para procesar la solicitud.
Comunicación cifrada — Todas las llamadas a la API usan HTTPS.
Privacidad primero — Construido por desarrolladores para desarrolladores, con privacidad, confiabilidad y calidad como prioridades principales.

Soporte


📧 Correo electrónico	support@l10n.dev
🐛 Problemas	GitHub Issues
📚 Documentación de API	api.l10n.dev/doc
🌐 Sitio web	l10n.dev

Licencia

MIT