localize.dev

Dokumentation / Agenten / Cursor

App mit Cursor lokalisieren

Fügen Sie den localize.dev MCP-Server und eine Cursor-Regel hinzu, damit der Agent von Cursor neue UI-Textübersetzungsschlüssel liefert und jede Sprache beim Bearbeiten ausfüllt.

Funktionsweise

Der Agent von Cursor liest MCP-Server aus .cursor/mcp.json. Fügen Sie localize.dev dort hinzu und der Agent kann die App auf hartcodierten Text überprüfen, ihn in Ihre i18n-Bibliothek umschreiben und übersetzen, und das im selben Chat, in dem er die Funktion erstellt.

npx localize-dev init --agent schreibt den Projektserver und .cursor/rules/localize.mdc, eine Regel, die auf Ihre UI-Dateien beschränkt ist und dem Agenten mitteilt, localize aufzurufen, nachdem er für Benutzer sichtbaren Text geändert hat.

Richten Sie es ein

Führen Sie zuerst npx localize-dev login in Ihrem Terminal aus. Es meldet Sie über den Browser an und speichert einen Schlüssel, den der Server liest, sodass die folgende Konfiguration keine enthält.

  1. Fügen Sie Lokalisierung zu .cursor/mcp.json hinzu.
  2. Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
  3. Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.
.cursor/mcp.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Was Sie erhalten

Wohin der Server geht
.cursor/mcp.json
Server
localize-dev mcp, gestartet mit npx auf Ihrem Computer
Schlüssel
Der, den npx localize-dev login gespeichert hat
Was init --agent hinzufügt
Der Server in .cursor/mcp.json, eine Regel für Ihre UI-Dateien und der Abschnitt AGENTS.md

Gut zu wissen

  • Cursor erhält keinen After-Edit-Hook; die Regel und der AGENTS.md-Abschnitt erledigen diese Aufgabe. Um zu erfassen, was der Agent verpasst hat, führen Sie npx localize-dev check --changed vor dem Commit aus oder fügen Sie --pre-commit zu init --agent hinzu.
  • Cursor ist eine Desktop-App und erbt nicht die Umgebung Ihrer Shell, weshalb der Snippet keinen Schlüssel trägt: Der Server liest den von npx localize-dev login gespeicherten.
  • Legen Sie den Server in ~/.cursor/mcp.json, um ihn in jedem Projekt zu haben, oder installieren Sie localize.dev aus der Plugin-Liste von Cursor.

Probieren Sie es aus

Fragen Sie etwas wie dieses. Der Agent sollte das add_language-Tool aufrufen.

“Fügen Sie Japanisch zu dieser App hinzu.”

Behalten Sie es übersetzt

Text, den der Agent hartcodiert hinterlässt, wird immer noch abgefangen: npx localize-dev check in CI schlägt eine Pull-Anfrage fehl, die nicht übersetzten Text hinzufügt, und sie benötigt keinen Schlüssel.

npx localize-dev check

Alle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.