localize.dev

Docs / Agents / Cursor

Localiser une application avec Cursor

Ajoutez le serveur MCP de localize.dev et une règle Cursor, afin que l'agent de Cursor fournisse de nouvelles clés de traduction de texte d'interface utilisateur et remplisse chaque langue lors de la modification.

Comment ça marche

L'agent de Cursor lit les serveurs MCP depuis .cursor/mcp.json. Ajoutez localize.dev là-bas et l'agent pourra vérifier l'application à la recherche de texte codé en dur, le réécrire dans votre bibliothèque i18n et le traduire, dans le même chat où il crée la fonctionnalité.

npx localize-dev init --agent écrit le serveur de projet et .cursor/rules/localize.mdc, une règle limitée à vos fichiers d'interface utilisateur qui indique à l'agent d'appeler localize après avoir modifié le texte visible par les utilisateurs.

Configurez-le

Exécutez d'abord npx localize-dev login dans votre terminal. Il vous connecte via le navigateur et enregistre une clé, que le serveur lit, de sorte que la configuration ci-dessous n'en contient aucune.

  1. Ajoutez la localisation à .cursor/mcp.json.
  2. Redémarrez l'agent ou rechargez ses serveurs MCP pour qu'il commence à localiser.
  3. Ouvrez votre dépôt et demandez-lui quelque chose de similaire à l'invite ci-dessous.
.cursor/mcp.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Ce que vous obtenez

Où va le serveur
.cursor/mcp.json
Serveur
localize-dev mcp, démarré avec npx sur votre machine
Clé
Celui que npx localize-dev login a sauvegardé
Ce que init --agent ajoute
Le serveur dans .cursor/mcp.json, une règle pour vos fichiers d'interface utilisateur et la section AGENTS.md

Bon à savoir

  • Cursor n'obtient pas de hook après édition ; la règle et la section AGENTS.md font ce travail. Pour rattraper ce que l'agent a manqué, exécutez npx localize-dev check --changed avant de commiter, ou ajoutez --pre-commit à init --agent.
  • Cursor est une application de bureau et n'hérite pas de l'environnement de votre shell, c'est pourquoi l'extrait ne porte pas de clé : le serveur lit celui que npx localize-dev login a enregistré.
  • Placez le serveur dans ~/.cursor/mcp.json pour l'avoir dans chaque projet, ou installez localize.dev depuis la liste des plugins de Cursor.

Essayez

Demandez quelque chose comme ceci. L'agent doit appeler l'outil add_language.

“Ajoutez le japonais à cette application.”

Gardez-le traduit

Le texte que l'agent laisse codé en dur est toujours détecté : npx localize-dev check dans CI échoue une demande de tirage qui ajoute une copie non traduite, et elle n'a pas besoin de clé.

npx localize-dev check

Tous les agents et la référence de l'outil se trouvent sur la page du serveur MCP.