Voir les projets Weblate et chercher des traductions dans le chat

À qui cela s’adresse

Ce guide s’adresse à qui a déjà une instance Weblate avec une API joignable et veut voir les projets et chercher des unités de traduction dans le chat. Le chemin officiel principal : démarrer @mmntm/weblate-mcp avec npx et configurer WEBLATE_API_URL et WEBLATE_API_TOKEN. Sans URL d’instance ni jeton, n’appeler rien.

Il convient à qui affiche d’abord les projets, puis trouve des traductions avec la syntaxe de filtre native Weblate. Les outils nommés ici en entier sont listProjects et searchUnitsWithFilters. Ne pas lire des outils d’écriture non cités comme une permission de modifier les traductions ; ne pas inventer de noms d’outils absents.

Premier essai en 3 minutes

La commande d’installation officielle suit. Prérequis : npx exécutable ici (les notes de développement mentionnent aussi Node.js 18+ et pnpm), plus une Weblate instance avec API access. La configuration est l’entrée MCP du client : command vaut npx, args valent -y et @mmntm/weblate-mcp, env contient WEBLATE_API_URL et WEBLATE_API_TOKEN. L’URL doit être la racine API de votre Weblate ; ne pas utiliser les noms d’hôte d’exemple de la documentation.

npx -y @mmntm/weblate-mcp

Page officielle :

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

Pour le premier essai, utiliser l’outil officiel listProjects : afficher tous les projets Weblate disponibles avec leur URL et metadata. Le succès est un retour de projets, pas un jeton refusé. listProjects atteint l’instance Weblate configurée ; ce n’est ni hors réseau ni sans frontière de confidentialité.

Cas d’usage

Cas 1 : voir quels projets existent sur l’instance. Correspond à listProjects. Le texte officiel dit URLs and metadata, sans paramètres de pagination ou de filtre ; n’utiliser que ce que le client montre. Succès : les noms de projets sont visibles.

Cas 2 : trouver des unités de traduction par filtre. Correspond à searchUnitsWithFilters. L’officiel dit qu’il utilise Weblate's native filtering syntax et que c’est une façon efficace de trouver des translations. Cette page ne donne pas d’expression de filtre copiable ; ne pas inventer de syntaxe. Succès : des unités correspondantes reviennent.

Limites d’usage

Les transports nommés ici incluent HTTP/SSE, Streamable HTTP et STDIO ; aucun port par défaut n’est écrit, ne pas en inventer. Jetons et URL d’instance uniquement dans l’env local. Cette page ne donne ni limites de débit, ni table d’outils en écriture, ni étapes pour annuler une traduction. Le côté développement mentionne aussi pnpm ; ce n’est pas un installeur principal de remplacement du chemin npx, donc ne pas les mettre à égalité.

Avant searchUnitsWithFilters, confirmer que le filtre vient de la syntaxe native Weblate, pas d’un mot-clé improvisé. listProjects répond seulement aux projets de l’instance et ne change aucune traduction tout seul.