zlib-mcp

Ein stdio-MCP-Server, der jedem KI-Agenten-Tool – Claude Code, Codex CLI, Cursor, Claude Desktop – die Möglichkeit gibt, in z-library zu suchen und Bücher herunterzuladen.

Bring dein eigenes Konto mit. Es gibt kein gemeinsames Backend, keinen API-Schlüssel, keinen Proxy: Der Server läuft auf deinem Rechner, spricht direkt mit z-library und nutzt deine Anmeldedaten und dein Kontingent.

Tools

zlib_download erscheint nur, wenn du ZLIB_DOWNLOAD_DIR gesetzt hast – ein MCP-Server, der standardmäßig überall Dateien schreiben kann, ist kein akzeptabler Standard. Du musst das Verzeichnis also selbst benennen.

Voraussetzungen

• Node.js ≥ 20

• Ein z-library-Konto

Einrichtung in 5 Minuten

1. Anmeldedaten besorgen

Wenn du deine remix_userid / remix_userkey bereits kennst, überspringe diesen Schritt. Andernfalls füge den Server nur mit deiner E-Mail und deinem Passwort hinzu (siehe die Konfigurationsausschnitte unten) und bitte deinen Agenten, einmal zlib_login auszuführen und die zurückgegebenen remix_id / remix_key dauerhaft in die Konfiguration einzutragen.

Du kannst es auch direkt aus einem Terminal ausführen:

ZLIB_EMAIL=you@example.com ZLIB_PASSWORD='…' npx zlib-mcp

2. Server zum Client hinzufügen

Jeder Client akzeptiert dieselben drei Dinge: den Befehl npx, das Argument zlib-mcp und einen env-Block.

claude mcp add zlib \
  --env ZLIB_REMIX_ID=123456 \
  --env ZLIB_REMIX_KEY=your_remix_userkey \
  --env ZLIB_DOWNLOAD_DIR="$HOME/Downloads/books" \
  -- npx -y zlib-mcp

Oder bearbeite ~/.claude.json / .mcp.json direkt mit dem untenstehenden JSON.

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

{
  "mcpServers": {
    "zlib": {
      "command": "npx",
      "args": ["-y", "zlib-mcp"],
      "env": {
        "ZLIB_REMIX_ID": "123456",
        "ZLIB_REMIX_KEY": "your_remix_userkey",
        "ZLIB_DOWNLOAD_DIR": "/Users/you/Downloads/books"
      }
    }
  }
}

{
  "mcpServers": {
    "zlib": {
      "command": "npx",
      "args": ["-y", "zlib-mcp"],
      "env": {
        "ZLIB_REMIX_ID": "123456",
        "ZLIB_REMIX_KEY": "your_remix_userkey",
        "ZLIB_DOWNLOAD_DIR": "/Users/you/Downloads/books"
      }
    }
  }
}

[mcp_servers.zlib]
command = "npx"
args = ["-y", "zlib-mcp"]

[mcp_servers.zlib.env]
ZLIB_REMIX_ID = "123456"
ZLIB_REMIX_KEY = "your_remix_userkey"
ZLIB_DOWNLOAD_DIR = "/Users/you/Downloads/books"

3. Ausprobieren

Finde Kleppmanns Designing Data-Intensive Applications im EPUB-Format und lade dann das erste Ergebnis herunter.

Konfiguration

Priorität der Anmeldedaten

1. ZLIB_REMIX_ID + ZLIB_REMIX_KEY

2. Zwischengespeicherte Anmeldedaten von einem früheren ZLIB_EMAIL-Login (~/.zlib-mcp/credentials.json, Modus 600)

3. ZLIB_EMAIL + ZLIB_PASSWORD → Login erfolgt beim ersten Tool-Aufruf, nicht beim Start

Der Cache existiert, damit ein Neustart des Clients nicht jedes Mal einen neuen Login auslöst – wiederholte Logins sind es, die das Anti-Missbrauchssystem von z-library aufmerksam machen. Er speichert nur die remix-ID und den remix-Key; dein Passwort wird niemals auf die Festplatte geschrieben, protokolliert oder von einem Tool zurückgegeben. Unter Windows ist der Modus 600 wirkungslos (das Betriebssystem ignoriert POSIX-Berechtigungen) – setze ZLIB_CREDENTIAL_CACHE=0, falls das für dich relevant ist.

Wenn nichts konfiguriert ist, startet der Server trotzdem und listet seine Tools auf; ein Aufruf gibt Hinweise, was zu setzen ist. Er stürzt nicht ab – ein abgestürzter MCP-Server erscheint in den meisten Clients nur als „nicht verfügbar“, ohne dass etwas zu debuggen wäre.

Fehlerbehebung

„Upstream-Host … scheint diese Anfrage zu blockieren“ – der Mirror steht hinter einer Anti-Bot-Wand. Setze ZLIB_HOST auf einen anderen und starte den Client neu. Bekannte Mirrors ändern sich häufig; 1lib.sk ist derzeit blockiert, pkuedu.xyz funktioniert derzeit. Alles, was dieselben /eapi/*-Endpunkte bedient, funktioniert.

„z-library hat die aktuellen Anmeldedaten abgelehnt“ – dein remix-Key ist abgelaufen. Führe zlib_login erneut aus und aktualisiere die Konfiguration. Wenn du den E-Mail/Passwort-Fallback verwendest, lösche ~/.zlib-mcp/credentials.json, um einen neuen Login zu erzwingen.

„Download-Kontingent erreicht“ – kostenlose Konten erhalten eine begrenzte Anzahl von Downloads pro Tag. zlib_limits zeigt den Zähler; er wird auf der Seite von z-library um Mitternacht UTC zurückgesetzt.

Im Client erscheint nichts – prüfe das MCP-Log des Clients; dieser Server schreibt alle Diagnosen nach stderr. ZLIB_LOG_LEVEL=debug macht es gesprächiger.

zlib_download fehlt – du hast ZLIB_DOWNLOAD_DIR nicht gesetzt. Das ist beabsichtigt.

Entwicklung

pnpm install
pnpm check      # format check → lint → typecheck → tests
pnpm build

Um eine unveröffentlichte Version direkt aus Git auszuprobieren, richte die command/args deines Clients auf npx / ["-y", "github:shiyi-0x7f/zlib-mcp"] – das prepare-Skript baut es bei der Installation.

Tests treffen nie den echten Upstream – fetch ist überall gestubbt.

Rechtliches

Dieses Tool bietet nur API-Zugriff auf dein eigenes z-library-Konto. Es hostet nichts, verteilt nichts und enthält keine urheberrechtlich geschützten Inhalte. Dass deine Nutzung dort, wo du dich befindest, legal ist, liegt in deiner Verantwortung. Dein Konto, dein Kontingent, dein Risiko – ein wegen Missbrauchs gesperrtes Konto ist deins zu verlieren.

Lizenz

MIT