verbatra mcp

Starte einen Model-Context-Protocol-Server über stdio: den Standard-Transport für lokale Prozesse, mit dem MCP-Clients (Claude Desktop, Claude Code, Cursor und andere) einen Tool-Server starten und mit ihm sprechen. Er gibt einem terminal-basierten oder headless Agenten dieselben Übersetzungsstatus-, Glossar- und Bearbeitungs-Fähigkeiten, die Studios Browser-Agent-Tools bereitstellen, ganz ohne Browser, Port oder ausgelieferte Single-Page-App.

Kurzform

verbatra mcp [flags]

@verbatra/mcp liefert außerdem sein eigenes Binary, sodass ein MCP-Client es direkt starten kann, ganz ohne die verbatra-CLI:

verbatra-mcp [flags]

Beide Formen akzeptieren dieselben Flags und starten denselben Server.

Flags

Fehlt --allow-spend, liest der Server stattdessen die Umgebungsvariable VERBATRA_MCP_ALLOW_SPEND: 1, true, yes oder on (Groß-/Kleinschreibung egal) zählt als an. Das CLI-Flag gewinnt immer gegenüber der Umgebungsvariable. Ohne beides werden translation.retranslateEntry und translation.translatePending überhaupt nicht bereitgestellt: Ein MCP-Client, der die Tools auflistet, sieht sie nie, und ein Aufruf beider Namen schlägt als unbekanntes Tool fehl. Das ist eine Garantie pro Prozess, keine Prüfung pro Aufruf, sodass ein spend-gesperrtes Tool strukturell nicht aufrufbar ist statt nur zur Laufzeit abgelehnt zu werden.

Einen MCP-Client konfigurieren

Zeige deinen MCP-Client auf das verbatra-mcp-Binary. Für Claude Desktop fügst du das zu deiner claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Lass den env-Block und sein --allow-spend ganz weg für einen Server, der nur schreibgeschützt und lokal bearbeitbar ist: project.snapshot, die Status- und Glossar-Tools sowie translation.editEntry rufen nie einen Provider auf und brauchen keinen Key. Füge --allow-spend zum args-Array hinzu, sobald du auch translation.retranslateEntry und translation.translatePending verfügbar haben willst, und setze die Umgebungsvariable für den API-Key, die dein konfigurierter Provider liest (siehe Provider).

Rufst du bereits alles über die verbatra-CLI auf, starte es stattdessen als Unterbefehl:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/cli", "mcp", "--cwd", "/path/to/your/project"]
    }
  }
}

Tools

translation.retranslateEntry und translation.translatePending werden nur bereitgestellt, wenn der Server mit --allow-spend gestartet wurde. Der Input jedes Tools, und der Output jedes Tools, dessen Ergebnisform klein und geschlossen ist, ist ein JSON-Schema, abgeleitet aus demselben zod-Schema, gegen das der Server den Aufruf validiert. Der Aufruf eines unbekannten Tool-Namens ist ein Fehler auf Protokollebene; der Aufruf eines bekannten Tools mit Input, der die Validierung nicht besteht, liefert ein Ergebnis, das das betroffene Feld nennt, sodass ein Agent den Fehler lesen und selbst korrigieren kann.

Secret-Redaktion

Jedes Tool-Ergebnis und jede Log-Zeile durchläuft dieselbe Secret-Redaktion, die auch Studio verwendet: Ein Wert, der wie ein Provider-API-Key aussieht, oder der exakte aktuelle Wert einer konfigurierten Provider-Umgebungsvariable, wird durch [REDACTED] ersetzt, bevor er den Client oder stderr überhaupt erreicht. glossary.get und glossary.write melden zudem, welche Begriffe redigiert wurden, sodass du einen geschwärzten Platzhalter vom echten Text unterscheiden und ihn nie zurückschreiben kannst.

stdout ist der Protokollkanal

Der stdio-Transport von MCP nutzt stdout ausschließlich für Protokollnachrichten. verbatra mcp und verbatra-mcp geben niemals ein Banner, eine Log-Zeile oder irgendetwas anderes auf stdout aus; jedes Log und jede Diagnose geht stattdessen auf stderr. Es wird überhaupt nichts ausgegeben, bis ein MCP-Client die erste Nachricht sendet.

Installation

@verbatra/mcp ist ein eigenständiges Paket, das über einen dynamischen Import geladen wird, sodass der Rest der CLI auch ohne es funktioniert. Ist es nicht installiert, beendet sich verbatra mcp mit 2 und:

Verbatra's MCP server requires @verbatra/mcp. Install it with: pnpm add -D @verbatra/mcp

verbatra-mcp direkt aufzurufen braucht überhaupt keine CLI: Installiere @verbatra/mcp allein, oder lass npx es wie oben gezeigt bei Bedarf holen.

Beispiele

# den MCP-Server nur mit lokalen, nicht spend-fähigen Tools starten
verbatra mcp

# zusätzlich die Provider-aufrufenden Tools bereitstellen
verbatra mcp --allow-spend

# ein Projekt außerhalb des aktuellen Verzeichnisses auflösen
verbatra mcp --cwd /path/to/project --config verbatra.config.ts

Exit-Codes

Siehe auch

• verbatra studio und Studio mit einem Browser-Agenten bedienen behandeln die Browser-basierte Agent-Oberfläche, die dieser Server ergänzt.
• Provider dokumentiert, aus welcher Umgebungsvariable jeder Provider seinen API-Key liest.
• verbatra check und verbatra diff sind dieselben Berechnungen, die status.check und status.diff bereitstellen.