Zum Hauptinhalt springen

libretranslate mcp

libretranslate mcp Verwaltet den MCP-Server für Sie: seine gespeicherte Konfiguration, einen HTTP-Hintergrundserver, einen Anmeldedienst und seine Registrierung in Ihren MCP-Clients.

npx libretranslate mcp config # asks for the settings in the terminal and saves them
npx libretranslate mcp config --base-url http://localhost:5000 --port 4000 # no prompts (scripts, CI): saves just these
npx libretranslate mcp config --web # the same, in a local web form
npx libretranslate mcp install # pick Claude Code / Codex / OpenCode and register libretranslate-mcp (stdio) in them
npx libretranslate mcp install --client claude,opencode --force # no picker (scripts, CI); --force replaces an entry
npx libretranslate mcp uninstall # pick the clients to remove the 'libretranslate' entry from (no saved config needed)
npx libretranslate mcp start # start in the background (needs a saved config); prints the URL for `claude mcp add`
npx libretranslate mcp start --api-key other --port 4000 # one-off values, never saved
npx libretranslate mcp status # running or stopped (exit 3), URL, pid, uptime
npx libretranslate mcp stop
npx libretranslate mcp boot enable # start at every login; `boot disable` / `boot status`

libretranslate mcp config​

Schreibt das Gerettete .env ()Konfiguration. Es funktioniert auf drei Arten:

  • Im Terminal (Ausfall). Es fragt nach jeder Einstellung, beginnend mit den gespeicherten Werten ()http://localhost:5000 für eine neue URL. Der API-Schlüssel wird maskiert eingegeben: enter behält den gespeicherten (oder lässt keinen) und - löscht es.
  • Mit Flaggen. In einer --base-url, --api-key ()- löscht es oder --portEs fragt nichts und rettet nur diese. Ohne Terminal braucht es sie. Ein Schlüssel, der übergeben wird, wenn eine Flagge in Ihrer Shell-Geschichte bleibt, also bevorzugen Sie die Eingabeaufforderung dafür.
  • in einem Webformular mit --web: eine lokale Seite, die im Browser geöffnet wird (--no-open nur die URL zu drucken. Ein leeres Geheimnis bewahrt das Gerettete.

Wenn ein Server läuft, heißt es so: Starten Sie ihn neu, um die Änderungen aufzunehmen. --config <file> oder LIBRETRANSLATE_CONFIG) schreibt eine andere Datei.

libretranslate mcp install​

Erkennt jeden Client, indem er seine --version, und registriert den Stdio-Server über die Client-eigene CLI, unter dem Namen libretranslate:

KundeCommand It Run
Claude Codeclaude mcp add -s user
Codexcodex mcp add
OpenCodeopencode mcp add --global

Der registrierte Befehl ist node <package>/dist/mcp/cli.js durch den absoluten Pfad, ohne Anmeldeinformationen: Der Server liest die gespeicherte Datei, wenn der Client sie startet ()LIBRETRANSLATE_CONFIG wird nur angenommen, wenn --config benennt eine andere Datei.

Jeder gefundene Kunde beginnt zu ticken. Eine, die bereits eine libretranslate Eintrag ist gekennzeichnet already installed, reinstalls und wird ersetzt. Ohne interaktives Terminal, --client ist erforderlich ()claude, codex, opencodeauch innerhalb der WSL claude@windows, codex@windows, opencode@windows, plus --force einen Eintrag zu ersetzen. --dry-run druckt die Befehle, anstatt sie auszuführen.

Beide install und uninstall Arbeiten Sie an der (globalen) Konfiguration auf Benutzerebene jedes Kunden. Projekt-scoped Einträge werden nie berührt.

libretranslate mcp uninstall​

Listen die Kunden mit einem libretranslate Eingabe, zeigt an, ob es stdio oder http, und entfernt jeden Eintrag dieses Namens: claude mcp remove -s user, codex mcp remove, und für OpenCode (der keine remove) eine Bearbeitung seiner globalen Konfigurationsdatei, die nur diesen Schlüssel löscht und Kommentare und Layout speichert.

Es ist ein einziger Befehl außer libretranslate mcp config das ohne gespeicherte Konfiguration läuft, sodass ein Client nach dem Wegfall der Konfiguration bereinigt werden kann. --client und --dry-run Arbeiten wie in install.

libretranslate mcp start, stop und status​

start führt den HTTP-Server losgelöst aus, mit seinem Pid und Login <config dir>/run/, und druckt seine URL, seine Protokolldatei und die claude mcp add Zeile, um es zu registrieren. Es braucht eine gespeicherte Konfiguration. --api-key, --base-url und --port Überschreiben Sie es nur für diesen Lauf und werden nie gerettet. --foreground dient stattdessen im aktuellen Prozess.

status Druckt mit URL, Pid und Uptime aus, ob der Server läuft, und beendet mit Code 3, wenn dies nicht der Fall ist. stop fordert den Server auf, durch einen Token-geschützten herunterzufahren POST /shutdownund signalisiert den Prozess nur, wenn dieser fehlschlägt.

libretranslate mcp boot​

boot enable installiert einen Dienst des aktuellen Benutzers, der den Server bei jedem Login startet, so dass kein sudo benötigt wird:

OSDienst
Linuxeine Systemd User Unit (auf WSL, systemd in aktivieren) /etc/wsl.conf)
macOSa LaunchAgent
Windowseine Anmeldeaufgabe

Der Dienst liest nur die gespeicherte Konfiguration. boot disable entfernt und boot status berichtet.