zlib-mcp

stdio MCP サーバーで、あらゆる AI エージェントツール（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 をご存知の場合は、先に進んでください。それ以外の場合は、メールアドレスとパスワードだけでサーバーを追加し（下記の設定スニペットを参照）、エージェントに zlib_login を一度実行してもらい、返された remix_id / remix_key を設定に恒久的に記入してください。

ターミナルから直接実行することもできます:

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

2. サーバーをクライアントに追加する

すべてのクライアントで同じ3つの要素を使用します: コマンド 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

または、以下の JSON を使用して ~/.claude.json / .mcp.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. 試してみる

Kleppmann の 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 とキーのみが保存されます。パスワードがディスクに書き込まれたり、ログに記録されたり、いかなるツールからも返されたりすることはありません。 Windows では 600 モードは何も行いません（OS が POSIX パーミッションを無視するため）。それが気になる場合は ZLIB_CREDENTIAL_CACHE=0 を設定してください。

何も設定されていなくても、サーバーは起動してツールを一覧表示します。ツールを呼び出すと、設定すべき内容の説明が返されます。クラッシュはしません。クラッシュした MCP サーバーは、ほとんどのクライアントで「利用不可」と表示されるだけで、デバッグの手がかりが何もありません。

トラブルシューティング

「上流ホスト … がこのリクエストをブロックしているようです」 — ミラーがアンチボットの壁の背後にあります。ZLIB_HOST を別のものに設定して、クライアントを再起動してください。既知のミラーは頻繁に変わります。1lib.sk は現在ブロックされており、pkuedu.xyz は現在動作しています。同じ /eapi/* エンドポイントを提供するものであれば何でも構いません。

「z-library が現在の認証情報を拒否しました」 — remix キーが期限切れです。zlib_login を再度実行して設定を更新してください。メールアドレス/パスワードのフォールバックを使用している場合は、~/.zlib-mcp/credentials.json を削除して新しいログインを強制してください。

「ダウンロードクォータに達しました」 — 無料アカウントは1日あたりのダウンロード数がわずかです。zlib_limits でカウンターを確認できます。カウンターは UTC の午前0時に z-library 側でリセットされます。

クライアントに何も表示されない — クライアントの 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 はすべてスタブ化されています。

法的情報

このツールは あなた自身の z-library アカウントへの API アクセスのみを提供します。何もホストせず、何も配布せず、著作権で保護されたコンテンツを一切同梱しません。お住まいの地域でこのツールの使用が合法であることを確認する責任はあなたにあります。あなたのアカウント、あなたのクォータ、あなたのリスク — 不正利用で停止されたアカウントは、あなたが失うものです。

ライセンス

MIT