zlib-mcp

Un servidor MCP sobre stdio que le da a cualquier agente de IA — Claude Code, Codex CLI, Cursor, Claude Desktop — la capacidad de buscar en z-library y descargar libros.

Trae tu propia cuenta. No hay backend compartido, ni clave API, ni proxy: el servidor se ejecuta en tu máquina, habla directamente con z-library y usa tus credenciales y tu cuota.

Herramientas

zlib_download solo aparece si configuras ZLIB_DOWNLOAD_DIR — un servidor MCP que pueda escribir archivos en cualquier lugar por defecto no es un comportamiento aceptable, así que tienes que nombrar el directorio tú mismo.

Requisitos

• Node.js ≥ 20

• Una cuenta de z-library

Configuración en 5 minutos

1. Obtén tus credenciales

Si ya conoces tu remix_userid / remix_userkey, salta al siguiente paso. Si no, añade el servidor solo con tu email y contraseña (ver los fragmentos de configuración más abajo), luego pide a tu agente que ejecute zlib_login una vez y pon el remix_id / remix_key devuelto en la configuración de forma permanente.

También puedes ejecutarlo directamente desde una terminal:

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

2. Añade el servidor a tu cliente

Cada cliente necesita las mismas tres cosas: el comando npx, el argumento zlib-mcp y un bloque env.

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

O edita ~/.claude.json / .mcp.json directamente usando el JSON de abajo.

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. Pruébalo

Encuentra el Designing Data-Intensive Applications de Kleppmann en epub y descarga el primer resultado.

Configuración

Precedencia de credenciales

1. ZLIB_REMIX_ID + ZLIB_REMIX_KEY

2. Credenciales en caché de un inicio de sesión anterior con ZLIB_EMAIL (~/.zlib-mcp/credentials.json, modo 600)

3. ZLIB_EMAIL + ZLIB_PASSWORD → se inicia sesión en la primera llamada a una herramienta, no al arrancar

La caché existe para que un reinicio del cliente no provoque un nuevo inicio de sesión cada vez — los inicios de sesión repetidos son lo que hace que el sistema antiabuso de z-library te detecte. Solo almacena el id y la clave remix; tu contraseña nunca se escribe en disco, se registra ni la devuelve ninguna herramienta. En Windows el modo 600 no tiene efecto (el sistema operativo ignora los permisos POSIX) — pon ZLIB_CREDENTIAL_CACHE=0 si eso te importa.

Si no hay nada configurado, el servidor igualmente arranca y lista sus herramientas; llamar a una devuelve instrucciones sobre qué configurar. No se bloquea — un servidor MCP bloqueado simplemente aparece como "no disponible" en la mayoría de clientes, sin nada que depurar.

Solución de problemas

"El host ascendente … parece estar bloqueando esta solicitud" — el espejo está detrás de un muro antibots. Pon ZLIB_HOST a otro y reinicia el cliente. Los espejos conocidos cambian a menudo; 1lib.sk está bloqueado actualmente, pkuedu.xyz funciona ahora mismo. Cualquier cosa que sirva los mismos endpoints /eapi/* servirá.

"z-library rechazó las credenciales actuales" — tu clave remix ha caducado. Ejecuta zlib_login de nuevo y actualiza la configuración. Si usas la alternativa de email/contraseña, borra ~/.zlib-mcp/credentials.json para forzar un inicio de sesión nuevo.

"cuota de descargas alcanzada" — las cuentas gratuitas tienen un número pequeño de descargas al día. zlib_limits muestra el contador; se reinicia en el lado de z-library a medianoche UTC.

No aparece nada en el cliente — revisa el registro MCP del cliente; este servidor escribe todos los diagnósticos en stderr. ZLIB_LOG_LEVEL=debug lo hace más hablador.

Falta zlib_download — no has configurado ZLIB_DOWNLOAD_DIR. Eso es a propósito.

Desarrollo

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

Para probar una versión no publicada directamente desde git, apunta el command/args de tu cliente a npx / ["-y", "github:shiyi-0x7f/zlib-mcp"] — el script prepare lo compila al instalarlo.

Las pruebas nunca tocan el servidor real — fetch está simulado en todas partes.

Legal

Esta herramienta solo proporciona acceso API a tu propia cuenta de z-library. No aloja nada, no distribuye nada y no incluye contenido con derechos de autor. Asegurarte de que su uso sea legal donde estás es tu responsabilidad. Tu cuenta, tu cuota, tu riesgo — una cuenta bloqueada por abuso es tuya para perder.

Licencia

MIT