MCP-Lingvanex-Translate

MCP-Prototyp – Übersetzungsserver

Dieses Projekt implementiert einen MCP (Model Context Protocol)-Server für Textübersetzung. Der Server unterstützt zwei Transportarten:

• stdio – für die Integration mit Claude Desktop
• http (streamable) – zum Testen und Arbeiten über HTTP + SSE

---

⚙️ Voraussetzungen

• Node.js >= 18
• Yarn oder npm
• Installiertes Claude Desktop (für stdio-Integration)
• Lingvanex Translator-Konto für Textübersetzung

---

🔑 Lingvanex Translator Einrichtung

Um den Lingvanex Translator zu nutzen, benötigen Sie ein Lingvanex-Konto.

1. Falls Sie noch keines haben, registrieren Sie sich kostenlos

2. Gehen Sie zum Tab Cloud API: Cloud API

3. Füllen Sie die Rechnungsadresse aus

4. Klicken Sie auf Weiter zur Zahlung

   • Für eine kostenlose Testversion ist es nicht erforderlich, Ihre Zahlungskarte hinzuzufügen

5. Ihr API-Schlüssel wird generiert und ist im Tab Cloud API sichtbar: API-Schlüssel

Jetzt sind Sie bereit, die Übersetzungs-API zu verwenden. Unten finden Sie ein Video-Tutorial zum gesamten Prozess (falls auf der Lingvanex-Seite verfügbar).

---

🚀 Installation & Build

# Clone the repository
git clone https://github.com/lingvanex-mt/MCP-Lingvanex-Translate.git
cd mcp-prototype

Abhängigkeiten installieren

yarn install

---

🔌 Ausführung im stdio-Modus (Claude Desktop)

Der stdio-Modus wird von Claude Desktop verwendet, um eine Verbindung zu lokalen MCP-Servern herzustellen.

Umgebungsvariable setzen:

TRANSPORT=stdio

Server starten:

yarn build
yarn start

Erwartete Ausgabe:

MCP stdio transport running
Translate MCP Server ready

---

🌐 Ausführung im HTTP-Modus (streamable)

Der http-Modus startet einen lokalen HTTP-Server mit HTTP-Transport. Nützlich für Browser-Tests oder mit curl.

Umgebungsvariablen setzen:

TRANSPORT=http
HTTP_PORT=3000

Server starten:

yarn build
yarn start

Server testen:

curl http://127.0.0.1:3000/ping

Erwartete Antwort:

{ "status": "ok", "transport": "http" }

MCP Inspector zum Debuggen verwenden:

npx @modelcontextprotocol/inspector

Wählen Sie in der MCP Inspector-Benutzeroberfläche Transporttyp – Streamable HTTP; URL – http://localhost:3000/mcp. und klicken Sie auf Verbinden.

---

🖥️ Integration mit Claude Desktop

Claude Desktop erkennt lokale MCP-Server über eine Konfigurationsdatei:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Beispielkonfiguration (Windows)

Öffnen (oder erstellen) Sie claude_desktop_config.json und fügen Sie hinzu:

{
  "mcpServers": {
    "translate": {
      "command": "node",
      "args": [
        "C:\\Users\\path\\to\\project\\dist\\index.js"
      ]
    }
  }
}

⚠️ Stellen Sie sicher, dass Sie den Pfad zu Ihrem lokalen dist/index.js nach dem Build aktualisieren!

---

✅ So überprüfen Sie es

1. Starten Sie Claude Desktop.
2. Geben Sie eine Anfrage ein wie: "Verwende das MCP-Tool translate_text, um 'Hello world' ins Russische zu übersetzen."
3. Wenn alles korrekt konfiguriert ist, ruft Claude Ihren MCP-Server auf und gibt die Übersetzung zurück.

---

📌 Verfügbare Tools

translate_text

Übersetzt Text von einer Sprache in eine andere.

Argumente:

• text – der zu übersetzende Text
• sourceLang – Quellsprachcode (z. B. "en")
• targetLang – Zielsprachcode (z. B. "ru")

Beispielanfrage:

{
  "tool": "translate_text",
  "args": {
    "text": "Good morning",
    "sourceLang": "en",
    "targetLang": "fr"
  }
}

Beispielantwort:

{
  "content": [
    { "type": "text", "text": "Bonjour" }
  ]
}

---