npm-Paket tube-search-mcp

Das Paket tube-search-mcp ist ein leichtgewichtiger stdio-zu-HTTP-Proxy, der deinen lokalen KI-Client mit dem Tube Search MCP-Server verbindet. Keine Server-Einrichtung erforderlich.

Wie es funktioniert

KI-Client ←(stdio)→ tube-search-mcp ←(HTTP)→ tube.archivarix.net/mcp

Das Paket liest MCP-Nachrichten von stdin, leitet sie über Streamable HTTP an den Remote-Server von Tube Search weiter und schreibt Antworten nach stdout. Dein KI-Client denkt, er kommuniziert mit einem lokalen MCP-Server.

Installation

Keine Installation nötig — direkt mit npx ausführen:

npx tube-search-mcp --api-key tsk_DEIN_SCHLUESSEL

Oder global installieren:

npm install -g tube-search-mcp

npm-Paket: npmjs.com/package/tube-search-mcp

Konfiguration

Vollständige Konfigurationsbeispiele für jeden Client findest du in der Schnellstart-Anleitung.

CLI-Optionen

Option	Beschreibung	Standard
`--api-key <key>`	API-Schlüssel (`tsk_...`)	Umgebungsvariable `TUBE_API_KEY`
`--url <url>`	Benutzerdefinierter MCP-Endpunkt	`https://tube.archivarix.net/mcp`
`--help`	Hilfe anzeigen	—
`--version`	Version anzeigen	—

Umgebungsvariablen

Variable	Beschreibung
`TUBE_API_KEY`	API-Schlüssel (erforderlich, wenn `--api-key` nicht angegeben)
`TUBE_MCP_URL`	Standard-MCP-Endpunkt-URL überschreiben

Wann npm-Paket, wann Remote URL?

Claude Desktop und Claude Code unterstützen beide Methoden:

npm-Paket (stdio) — funktioniert mit allen MCP-Clients, keine Firewall-Probleme
Remote URL — kein npm/Node.js erforderlich, etwas weniger Latenz, nur von Claude Desktop und Claude Code unterstützt

Für Cursor und VS Code ist das npm-Paket die einzige Option.

Fehlerbehebung

Fehler: "TUBE_API_KEY environment variable is required"

Stelle sicher, dass du TUBE_API_KEY in der Umgebungskonfiguration deines Clients gesetzt hast oder übergib den Schlüssel über --api-key.

Verbindungszeitüberschreitung

Prüfe, ob du eine aktive Internetverbindung hast. Das Paket muss tube.archivarix.net erreichen können.

Authentifizierung fehlgeschlagen

Überprüfe, ob dein API-Schlüssel unter Profil → API gültig ist. Wenn du ihn neu generiert hast, aktualisiere den Schlüssel in deiner Client-Konfiguration.

Erster Start ist langsam

Der erste npx-Start lädt das Paket herunter. Nachfolgende Starts verwenden die gecachte Version.

← Zurück zur MCP-Anleitung