zlib-mcp

Сервер MCP на stdio, который даёт любому ИИ-агенту — Claude Code, Codex CLI, Cursor, Claude Desktop — возможность искать в z-library и скачивать книги.

Используйте свой аккаунт. Никакого общего бэкенда, API-ключа или прокси: сервер работает на вашей машине, общается напрямую с z-library и использует ваши учётные данные и вашу квоту.

Инструменты

zlib_download появляется только после того, как вы зададите ZLIB_DOWNLOAD_DIR — MCP-сервер, который по умолчанию может писать файлы куда угодно, не является приемлемым по умолчанию, поэтому вы должны сами указать директорию.

Требования

• Node.js ≥ 20

• Аккаунт z-library

Настройка за 5 минут

1. Получите свои учётные данные

Если вы уже знаете свои remix_userid / remix_userkey, пропустите этот шаг. В противном случае добавьте сервер, указав только email и пароль (см. примеры конфигурации ниже), затем попросите агента один раз выполнить zlib_login и вставьте полученные remix_id / remix_key в конфигурацию на постоянной основе.

Вы также можете запустить это прямо из терминала:

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

2. Добавьте сервер в ваш клиент

Каждый клиент принимает одни и те же три вещи: команду npx, аргумент zlib-mcp и блок 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

Или отредактируйте ~/.claude.json / .mcp.json напрямую, используя 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. Попробуйте

Найдите мне книгу Клеппмана Designing Data-Intensive Applications в формате epub, затем скачайте первый результат.

Конфигурация

Приоритет учётных данных

1. ZLIB_REMIX_ID + ZLIB_REMIX_KEY

2. Кэшированные учётные данные от предыдущего входа через ZLIB_EMAIL (~/.zlib-mcp/credentials.json, режим 600)

3. ZLIB_EMAIL + ZLIB_PASSWORD → вход выполняется при первом вызове инструмента, а не при запуске

Кэш существует для того, чтобы перезапуск клиента не вызывал новый вход каждый раз — повторные входы — это то, что заставляет систему защиты от злоупотреблений z-library обращать на вас внимание. Он хранит только remix id и key; ваш пароль никогда не записывается на диск, не логируется и не возвращается ни одним инструментом. В Windows режим 600 не работает (ОС игнорирует права POSIX) — установите ZLIB_CREDENTIAL_CACHE=0, если это для вас важно.

Если ничего не настроено, сервер всё равно запускается и показывает свои инструменты; вызов любого из них вернёт инструкции о том, что нужно задать. Он не падает — упавший MCP-сервер просто отображается как «недоступен» в большинстве клиентов, и нечего отлаживать.

Устранение неполадок

«Внешний хост … похоже, блокирует этот запрос» — зеркало находится за анти-бот-стеной. Установите ZLIB_HOST на другое и перезапустите клиент. Известные зеркала часто меняются; 1lib.sk сейчас заблокирован, pkuedu.xyz сейчас работает. Подойдёт любой, кто обслуживает те же конечные точки /eapi/*.

«z-library отклонила текущие учётные данные» — ваш remix-ключ истёк. Запустите zlib_login снова и обновите конфигурацию. Если вы используете запасной вариант с email/паролем, удалите ~/.zlib-mcp/credentials.json, чтобы принудительно выполнить новый вход.

«достигнута квота на скачивание» — бесплатные аккаунты получают небольшое количество загрузок в день. zlib_limits показывает счётчик; он сбрасывается на стороне z-library в полночь по UTC.

В клиенте ничего не появляется — проверьте журнал MCP клиента; этот сервер записывает всю диагностику в stderr. ZLIB_LOG_LEVEL=debug делает его более разговорчивым.

zlib_download отсутствует — вы не задали ZLIB_DOWNLOAD_DIR. Это сделано намеренно.

Разработка

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

Чтобы попробовать невыпущенную версию прямо из git, укажите в клиенте command/args на npx / ["-y", "github:shiyi-0x7f/zlib-mcp"] — скрипт prepare собирает его при установке.

Тесты никогда не обращаются к реальному внешнему серверу — fetch везде заглушён.

Правовая информация

Этот инструмент предоставляет только API-доступ к вашему собственному аккаунту z-library. Он ничего не хостит, ничего не распространяет и не содержит защищённого авторским правом контента. Обеспечение законности его использования в вашей юрисдикции — ваша ответственность. Ваш аккаунт, ваша квота, ваш риск — аккаунт, забаненный за злоупотребления, вы потеряете сами.

Лицензия

MIT