DeepL MCP-Server

Ein MCP-Server (Model Context Protocol), der hochwertige Übersetzungsfunktionen über die DeepL-API bereitstellt.

Funktionen

Dieser Server bietet 24 Tools für die Arbeit mit DeepL:

Übersetzungsfunktionen

• Modellauswahl der nächsten Generation — Verwenden Sie model_type-Werte wie quality_optimized oder prefer_quality_optimized

• Kontrolle der Förmlichkeit — Passen Sie den Tonfall für formelle/informelle Kontexte an

• Kontext-Parameter — Geben Sie zusätzlichen Kontext für eine bessere Genauigkeit an (wird nicht berechnet)

• Glossar-Unterstützung — Erstellen, auflisten, prüfen, verwenden und löschen Sie DeepL v3-Glossare

• Batch-Übersetzung — Übersetzen Sie mehrere Texte in einer einzigen Anfrage

• Formatierung beibehalten — Behalten Sie die ursprüngliche Textformatierung bei

• HTML/XML-Tag-Behandlung — Verwenden Sie tag_handling, tag_handling_version, ignore_tags, splitting_tags und verwandte Optionen

• Abrechnungstransparenz — Verwenden Sie show_billed_characters, um die Anzahl der berechneten Zeichen in Übersetzungsantworten einzubeziehen

• Dokumentenübersetzung — Hochladen, Abfragen und Herunterladen übersetzter Dateien

• v3-Sprachmetadaten — Abrufen produktspezifischer Sprachunterstützung und Funktionsregeln

• Translation Memories — Auflisten von Translation Memories des Kontos und deren Verwendung in Übersetzungsanfragen

• Stilregeln — Auflisten, Erstellen, Prüfen, Umbenennen, Löschen und Verwenden von Stilregel-Listen

• Einrichtung von Voice-Sitzungen — Anfordern oder Wiederverbinden von DeepL Voice Echtzeit-WebSocket-Sitzungen; das Audio-Streaming erfolgt über die zurückgegebene WebSocket-URL

• DeepL Write-Optionen — Umformulieren mit writing_style und tone, wenn der Plan die Write-API unterstützt

• Kontrolle der Satzteilung — Steuern Sie, wie Sätze geteilt werden

Automatische API-Typ-Erkennung

Der Server erkennt automatisch, ob Sie die Free- oder Pro-API verwenden, basierend auf Ihrem Schlüsselformat:

• Schlüssel, die auf :fx enden → Free API (api-free.deepl.com)

• Andere Schlüssel → Pro API (api.deepl.com)

Related MCP server: GeoServer MCP Server

Voraussetzungen

• Node.js 18+ (einschließlich Node.js 25)

• DeepL API-Schlüssel — Hier registrieren (Kostenlose Stufe verfügbar)

Schnellstart

1. Klonen und Erstellen

git clone https://github.com/watchdealer-pavel/deepl-mcp-server.git
cd deepl-mcp-server
npm install

2. Konfigurieren Sie Ihren MCP-Client

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "deepl": {
      "command": "node",
      "args": ["/path/to/deepl-mcp-server/build/index.js"],
      "env": {
        "DEEPL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code (.mcp.json in Ihrem Projekt):

{
  "mcpServers": {
    "deepl": {
      "command": "node",
      "args": ["/path/to/deepl-mcp-server/build/index.js"],
      "env": {
        "DEEPL_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Starten Sie Ihren MCP-Client neu

Starten Sie Claude Desktop oder Claude Code neu, um den Server zu laden.

Nutzungsbeispiele

Grundlegende Übersetzung

{
  "text": "Hello, how are you?",
  "target_lang": "DE"
}

Formelle Übersetzung mit Kontext

{
  "text": "Thanks for your help!",
  "target_lang": "DE",
  "formality": "more",
  "context": "Business email to a client"
}

Batch-Übersetzung

{
  "text": ["Hello", "Goodbye", "Thank you"],
  "target_lang": "FR"
}

API-Nutzung prüfen

Verwenden Sie get_usage, um Ihr aktuelles Kontingent zu sehen:

{
  "character_count": 12500,
  "character_limit": 500000,
  "characters_remaining": 487500,
  "percent_used": "2.50%",
  "api_type": "Free"
}

Unterstützte Sprachen

Quellsprachen (automatisch erkannt, falls weggelassen)

AR, BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, HU, ID, IT, JA, KO, LT, LV, NB, NL, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH

Zielsprachen

Alle Quellsprachen plus regionale Varianten:

• EN-GB — Britisches Englisch

• EN-US — Amerikanisches Englisch

• PT-BR — Brasilianisches Portugiesisch

• PT-PT — Europäisches Portugiesisch

• ZH-HANS — Vereinfachtes Chinesisch

• ZH-HANT — Traditionelles Chinesisch

Verwenden Sie get_target_languages für eine vollständige Liste mit Indikatoren zur Unterstützung von Förmlichkeit.

Fehlerbehandlung

Der Server behandelt häufige API-Fehler:

• 400 — Ungültige Parameter

• 401/403 — Authentifizierung fehlgeschlagen oder Funktion im aktuellen Plan nicht verfügbar

• 429 — Ratenlimit überschritten

• 456 — Kontingent überschritten

Sicherheit und OSV-Status

Dieses Repository wurde mit dem OSV-Scanner von Google gescannt und in einen sauberen Zustand versetzt.

• Letztes Scan-Ergebnis: 0 bekannte Abhängigkeitsschwachstellen

• Berichte werden in .osv/osv-report.json und .osv/osv-summary.md geschrieben

• Sanierungshinweise finden Sie in .osv/remediation-notes.md

• Die anfälligen direkten Abhängigkeitsketten wurden durch ein Upgrade von @modelcontextprotocol/sdk und axios behoben

Führen Sie den Scan lokal aus:

export PATH="$HOME/.local/bin:$PATH"
osv-project-scan .

Entwicklung

# Watch mode (auto-rebuild)
npm run watch

# Manual build
npm run build

# Run the server
npm start

# Test with MCP Inspector
npm run inspector

# Run live end-to-end tests against DeepL API
# Requires DEEPL_API_KEY in the environment and consumes a small number of billable characters.
npm run test:live

Der Live-Test umfasst Übersetzung, Sprachauflistung, v3-Sprachmetadaten, Auflistung von Translation Memories, Auflistung/Erstellung/Abruf/Aktualisierung/Löschung von Stilregeln (sofern verfügbar), Anforderung von Voice-Sitzungen (sofern verfügbar), Nutzung, Glossar-Erstellung/-Nutzung/-Löschung, Dokumenten-Upload/-Status/-Download und DeepL Write. Kostenlose API-Schlüssel können einen erwarteten Plan-Fehler für DeepL Write zurückgeben.

Lizenz

MIT-Lizenz — siehe LICENSE-Datei.

Links

• DeepL API-Dokumentation

• DeepL Pro API — Registrieren Sie sich für den API-Zugriff

• Model Context Protocol — MCP-Dokumentation