localize.dev

Documenti / Agenti / Cursor

Localizza un'app con Cursor

Aggiungi il server MCP di localize.dev e una regola Cursor, in modo che l'agente di Cursor fornisca nuove chiavi di traduzione del testo dell'interfaccia utente e compili ogni lingua durante la modifica.

Come funziona

L'agente di Cursor legge i server MCP da .cursor/mcp.json. Aggiungi localize.dev lì e l'agente potrà controllare l'app per testi codificati, riscriverli nella tua libreria i18n e tradurli, nella stessa chat in cui crea la funzionalità.

npx localize-dev init --agent scrive il server di progetto e .cursor/rules/localize.mdc, una regola limitata ai tuoi file UI che dice all'agente di chiamare localize dopo aver modificato il testo visibile dalle persone.

Configuralo

Esegui prima npx localize-dev login nel tuo terminale. Ti autentica tramite il browser e salva una chiave, che il server legge, quindi la configurazione sottostante non ne contiene nessuna.

  1. Aggiungi localize a .cursor/mcp.json.
  2. Riavvia l'agente o ricarica i suoi server MCP, in modo che avvii localize.
  3. Apri il tuo repository e chiedigli qualcosa come il prompt qui sotto.
.cursor/mcp.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Cosa ottieni

Dove va il server
.cursor/mcp.json
Server
localize-dev mcp, avviato con npx sulla tua macchina
Chiave
Quello che npx localize-dev login ha salvato
Cosa aggiunge init --agent
Il server in .cursor/mcp.json, una regola per i tuoi file dell'interfaccia utente e la sezione AGENTS.md

Buono a sapersi

  • Cursor non ottiene un hook post-modifica; la regola e la sezione AGENTS.md svolgono questo compito. Per catturare ciò che l'agente ha perso, esegui npx localize-dev check --changed prima di eseguire il commit, o aggiungi --pre-commit a init --agent.
  • Cursor è un'app desktop e non eredita l'ambiente della tua shell, motivo per cui lo snippet non contiene alcuna chiave: il server legge quello salvato da npx localize-dev login.
  • Metti il server in ~/.cursor/mcp.json per averlo in ogni progetto, o installa localize.dev dall'elenco dei plugin di Cursor.

Provalo

Chiedi qualcosa del genere. L'agente dovrebbe chiamare lo strumento add_language.

“Aggiungi il giapponese a questa app.”

Mantienilo tradotto

Il testo che l'agente lascia hardcoded viene comunque rilevato: npx localize-dev check in CI fallisce una pull request che aggiunge testo non tradotto e non necessita di una chiave.

npx localize-dev check

Tutti gli agenti e il riferimento allo strumento si trovano nella pagina del server MCP.