Ver proyectos Weblate y buscar traducciones en el chat

Para quién

Esta guía es para quien ya tiene una instancia Weblate con API alcanzable y quiere ver proyectos y buscar unidades de traducción en el chat. La ruta oficial principal es arrancar @mmntm/weblate-mcp con npx y configurar WEBLATE_API_URL y WEBLATE_API_TOKEN. Sin URL de instancia y token no llames nada.

Encaja con quien primero muestra proyectos y luego encuentra traducciones con la sintaxis de filtro nativa de Weblate. Las herramientas que esta página nombra por completo son listProjects y searchUnitsWithFilters. No encaja leer herramientas de escritura no citadas como permiso para cambiar traducciones; no inventes nombres de herramientas que no estén escritos.

Primer intento en 3 minutos

El comando oficial de instalación es el siguiente. Requisitos: npx ejecutable aquí (las notas de desarrollo también mencionan Node.js 18+ y pnpm) y una Weblate instance con API access. La configuración es el ítem MCP del cliente: command es npx, args son -y y @mmntm/weblate-mcp, env guarda WEBLATE_API_URL y WEBLATE_API_TOKEN. La URL debe ser la raíz API de tu Weblate; no uses nombres de host de ejemplo de la documentación.

npx -y @mmntm/weblate-mcp

Página oficial:

https://github.com/mmntm/weblate-mcp

Para el primer intento usa la herramienta oficial listProjects: muestra todos los proyectos Weblate disponibles con su URL y metadata. El éxito es que vuelvan proyectos, no un token rechazado. listProjects alcanza la instancia Weblate configurada; no lo leas como sin red ni sin límite de privacidad.

Casos de uso

Caso 1: ver qué proyectos hay en la instancia. Corresponde a listProjects. El texto oficial dice URLs and metadata y no nombra paginación ni parámetros de filtro; usa solo lo que muestre el cliente. En el éxito se ven los nombres de proyecto.

Caso 2: encontrar unidades de traducción por filtro. Corresponde a searchUnitsWithFilters. Lo oficial dice que usa Weblate's native filtering syntax y que es una forma eficaz de encontrar translations. Esta página no da una expresión de filtro copiable; no inventes sintaxis. El éxito es que vuelvan unidades coincidentes.

Límites de uso

Los transportes nombrados aquí incluyen HTTP/SSE, Streamable HTTP y STDIO; no hay puerto por defecto escrito, no inventes uno. Token y URL de instancia solo en el env local. Esta página no da límites de ritmo, tabla de herramientas de escritura ni pasos para deshacer una traducción. El lado de desarrollo también menciona pnpm; no es un instalador principal sustituto de la ruta npx, no los pongas como dos primeras opciones iguales.

Antes de llamar searchUnitsWithFilters, confirma que el filtro viene de la sintaxis nativa de Weblate, no de una palabra improvisada. listProjects solo responde qué proyectos hay en la instancia y no cambia ninguna traducción por sí solo.