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.
- Fügen Sie Lokalisierung zu .cursor/mcp.json hinzu.
- Starte den Agenten neu oder lade seine MCP-Server neu, damit er mit der Lokalisierung beginnt.
- Öffne dein Repository und frage es etwas Ähnliches wie die Eingabeaufforderung unten.
{
"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 logingespeichert hat - Was
init --agenthinzufügt - Der Server in
.cursor/mcp.json, eine Regel für Ihre UI-Dateien und der AbschnittAGENTS.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 Sienpx localize-dev check --changedvor dem Commit aus oder fügen Sie--pre-commitzuinit --agenthinzu. - 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 logingespeicherten. - 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 checkAlle Agenten und der Tool-Referenz sind auf der MCP-Serverseite.