localizely-mcp

MCP-Server für Localizely — verwalten Sie Übersetzungsdateien (Flutter ARB, iOS .strings, Android XML, JSON und mehr) über natürliche Sprache von jedem MCP-kompatiblen Client (Claude Desktop, Claude Code, Cursor usw.).

Werkzeuge

Unterstützte Dateiformate: flutter_arb, json, android_xml, ios_strings, ios_stringsdict, java_properties, rails_yaml, angular_xlf, dotnet_resx, po, pot, csv, xlsx.

Die Localizely-API stellt kein CRUD pro String bereit — Massenoperationen laufen über Datei-Upload/-Download; localizely_update_key erstellt unter der Haube eine winzige Datei mit einem einzelnen Schlüssel für einmalige Bearbeitungen.

Related MCP server: tolgee-mcp

Voraussetzungen

• Python 3.10+

• Ein Localizely-Konto und -Projekt

• Ein privater Localizely-API-Schlüssel — Kontoeinstellungen → API-Schlüssel → https://app.localizely.com/settings/api-keys

• uv installiert (uvx ist darin enthalten) — empfohlen, kein lokales Klonen und kein venv erforderlich

Dieses Paket ist nicht auf PyPI veröffentlicht. Es wird direkt aus diesem öffentlichen GitHub-Repository über die Git-Unterstützung von uv ausgeführt — kein separater Bereitstellungs- oder Veröffentlichungsschritt erforderlich.

Verwendung

Claude Desktop / Claude Code — empfohlen (uvx, kein Klonen nötig)

Fügen Sie Ihrer MCP-Konfiguration (claude_desktop_config.json oder .mcp.json) Folgendes hinzu:

{
  "mcpServers": {
    "localizely": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/adborroto/localizely-mcp", "localizely-mcp"],
      "env": {
        "LOCALIZELY_API_TOKEN": "your-api-token",
        "LOCALIZELY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

uvx holt das Repository, erstellt eine isolierte Umgebung und führt den Einstiegspunkt localizely-mcp bei Bedarf aus — nichts muss manuell installiert oder aktualisiert werden. Legen Sie für Stabilität einen bestimmten Commit/Tag mit git+https://github.com/adborroto/localizely-mcp@<tag-or-sha> fest.

Starten Sie den Client nach dem Bearbeiten der Konfiguration neu.

Lokales Klonen (Alternative)

git clone https://github.com/adborroto/localizely-mcp.git
cd localizely-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install .

cp .env.example .env
# edit .env and set LOCALIZELY_API_TOKEN

Richten Sie Ihre MCP-Konfiguration dann direkt auf das Python des venv aus:

{
  "mcpServers": {
    "localizely": {
      "command": "/absolute/path/to/localizely-mcp/.venv/bin/localizely-mcp",
      "env": {
        "LOCALIZELY_API_TOKEN": "your-api-token",
        "LOCALIZELY_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

Der Server kommuniziert über stdio, wie vom MCP-Protokoll erwartet — er ist nicht für den interaktiven Betrieb gedacht.

So finden Sie Ihre Projekt-ID

Jedes Werkzeug akzeptiert eine project_id. Finden Sie sie auf der Seite Meine Projekte in der Localizely-Web-App — es ist die UUID in der Projekt-URL oder in den Projekteinstellungen.

Wenn Sie hauptsächlich mit einem einzelnen Projekt arbeiten, setzen Sie LOCALIZELY_PROJECT_ID in Ihrer Umgebung (oder im env-Block der MCP-Konfiguration), anstatt bei jedem Aufruf project_id zu übergeben — jedes Werkzeug greift darauf zurück, wenn das Argument weggelassen wird. Sie können project_id weiterhin explizit übergeben, um bei einem einmaligen Aufruf ein anderes Projekt anzusprechen.

Sicherheit

• Committen Sie Ihre .env-Datei niemals und betten Sie Ihren API-Token niemals fest in den Code ein — .gitignore schließt .env bereits aus.

• Der API-Token wird beim Start aus der Umgebung gelesen; der Server weigert sich, ohne ihn zu starten.

• Behandeln Sie Ihren Localizely-API-Schlüssel wie alle anderen Zugangsdaten: schränken Sie ihn auf das ein, was Sie benötigen, rotieren Sie ihn bei einem Leak und teilen Sie ihn nicht in Issues, PRs oder Logs.

Wenn Sie ein Sicherheitsproblem finden, erstellen Sie bitte einen privaten Bericht, anstatt ein öffentliches Issue zu eröffnen.

Lizenz

MIT — siehe LICENSE.