MCP 服务器 · 社区项目

zlib-mcp

将 Z-Library 图书搜索、下载链接和账号额度查询接入 AI 客户端的本地 MCP 服务器。使用用户自己的账号，通过 stdio 运行；配置下载目录后可将选中的图书保存到本地。

5 StarsMITTypeScript20 天前更新

项目介绍

zlib-mcp 把 Z-Library 的图书检索和下载流程封装为 MCP 工具，适合在已有 AI 客户端里先查书、选定版本，再决定获取链接或保存文件。服务运行在本机，通过 stdio 与客户端通信，直接使用你配置的账号访问上游。它不是共享账号服务，也没有提供网页阅读器或全文分析能力。项目代码使用 MIT 许可证；获取内容仍应限于自己有权访问的资料。

核心功能

zlib_search 图书搜索

按书名、作者或 ISBN 查询，支持格式、语言、年份区间、排序和分页。每页默认 10 条，最多 50 条；结果保留书目信息及后续下载所需的 id/hash。

zlib_get_download_url 下载链接

用同一条搜索结果的 id/hash 获取短期、会话绑定的下载 URL，不保存文件。工具说明提示该操作会消耗当日下载额度。

zlib_download 本地保存

仅配置 ZLIB_DOWNLOAD_DIR 后注册。将文件流式写入指定目录并返回路径、文件名和字节数；清理文件名、为已有名称增加编号，并默认限制为 524288000 字节。allow_large 可显式放宽大小限制。

zlib_limits 额度查询

读取已下载数量、额度上限、剩余额度和会员状态，便于在请求下载链接前检查账号状态。

zlib_login 凭据交换

接受邮箱和密码并返回 remix ID/key；不会自动替换运行中的凭据配置，需要保存配置并重启。也可直接使用环境变量提供已有的 remix 凭据。

安装与连接

准备 Node.js 20+，把 README 的 npx 启动方式加入自己的 MCP 客户端，再填入完整的 remix ID/key。仅需要搜索和链接时可以省略下载目录，需要保存文件时再启用。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装 zlib-mcp，项目地址 https://github.com/shiyi-0x7f/zlib-mcp。先读取 README.md、README.zh-CN.md、package.json、src/config.ts 和 src/credentials.ts，确认 Node.js 20+ 要求以及目标客户端。使用仓库提供的 npx -y zlib-mcp 配置接入本地 stdio MCP，保留已有客户端配置。优先配置完整的 ZLIB_REMIX_ID 和 ZLIB_REMIX_KEY，仅在我需要下载时设置 ZLIB_DOWNLOAD_DIR。需要我提供凭据、授予额外权限或覆盖文件时先确认；不要在回答、日志或版本库中暴露秘密，也不要自行选择未知上游。重启后验证 4 个或 5 个工具，再经我同意查询额度并搜索指定书名；获取下载链接或保存文件前先确认具体条目及额度消耗。没有真实账号或上游不可达时，明确记录未验证部分，不要把本地测试当作真实下载成功。

01开始前准备

Node.js 20+，能够执行 npx
Claude Code、Claude Desktop、Cursor 或 Codex CLI
用户自己的账号，以及确认可信的上游域名
如需下载，准备一个允许客户端写入的目录

02复制安装命令或配置

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

03按步骤完成安装

1
准备账号凭据与运行环境
确认本机具备 Node.js 20+。准备完整的 ZLIB_REMIX_ID 和 ZLIB_REMIX_KEY，并确认要连接的上游可信；不要把真实凭据提交到项目仓库。需要本地保存时，确定专用下载目录。
2
将启动配置加入一个客户端
Claude Code 可复制本页添加命令并替换凭据。Claude Desktop 可将 JSON 合并到 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json。Cursor 使用 .cursor/mcp.json 或 ~/.cursor/mcp.json。不要覆盖已有 mcpServers 条目；把示例下载路径改成自己的路径，不下载时删除 ZLIB_DOWNLOAD_DIR。
3
重启并验证搜索工具
重启所选客户端，检查 4 个或 5 个工具是否出现。先调用 zlib_limits，再让 zlib_search 搜索指定书名或作者；需要时添加 extensions、languages 或年份条件，检查返回条目的版本及 id/hash。
4
选定条目后获取文件
从同一条搜索结果取出 id/hash。只要链接就调用 zlib_get_download_url；需要保存到配置目录时调用 zlib_download。两者都应在明确接受额度消耗后执行。检查返回的路径、文件名和字节数；遇到账号或上游错误时先处理配置，不要盲目重复下载。

如何确认安装成功

重启客户端后检查工具列表。未配置下载目录时应有 4 个工具，配置后为 5 个。先调用 zlib_limits，确认返回账号额度，再用 zlib_search 搜索一个明确的书名或作者并检查结果是否包含 id/hash。只有用户选定条目并同意消耗额度后，才验证链接或实际下载。

使用前注意

README 默认 ZLIB_HOST 为 pkuedu.xyz；本次未验证其可达性或可信度，发送凭据前请自行确认。
邮箱密码回退方式会按需登录并缓存会话；磁盘缓存不能单独代替环境配置。长期使用可保存完整的 remix ID/key。
ZLIB_CREDENTIAL_CACHE=0 可禁用缓存；默认缓存路径为 ~/.zlib-mcp/credentials.json。
zlib_login 的参数和返回凭据可能进入客户端历史，应按客户端规则保护。

使用场景

SCENARIO 01

在对话里筛选图书版本

用书名或作者搜索，再按语言、出版年份和文件格式筛选，保留候选条目的 id/hash 供用户选择。

SCENARIO 02

把选定资料保存到阅读目录

用户确认有权获取某条资料后，先检查额度，再下载到预设目录；后续阅读或解析需要其他工具。

使用评价

评价依据是仓库 README、配置与工具实现、许可证及提交记录，并补充了源码构建和 82 项模拟测试。工具职责划分清楚，下载需要显式配置，安装资料覆盖多个客户端。项目目前规模较小，上游镜像、账号状态和下载额度会直接影响实际体验；本次没有真实账号验证，不能据此承诺稳定可用。

值得一试的地方

搜索、链接、下载与额度分别调用，便于按需授权
中英文 README 给出多个客户端配置示例
源码构建与 82 项模拟测试通过，包含凭据、路径和错误处理测试

使用前要知道

仅 5 Stars、3 Forks，公开提交历史较短
上游可达性和真实登录下载未经本次验证
文件名与路径处理不等于完整文件系统安全沙箱

README

zlib-mcp

Overview

Getting started

准备 Node.js 20+，把 README 的 npx 启动方式加入自己的 MCP 客户端，再填入完整的 remix ID/key。仅需要搜索和链接时可以省略下载目录，需要保存文件时再启用。
README 将项目定义为自带账号的 Z-Library MCP，使用 Node.js 20+ 和 npx 启动，支持本地 stdio 客户端。
配置可以使用 remix ID/key，或邮箱密码按需交换；仅设置 ZLIB_DOWNLOAD_DIR 时才提供本地下载工具。
重启客户端后检查工具列表。未配置下载目录时应有 4 个工具，配置后为 5 个。先调用 zlib_limits，确认返回账号额度，再用 zlib_search 搜索一个明确的书名或作者并检查结果是否包含 id/hash。只有用户选定条目并同意消耗额度后，才验证链接或实际下载。

Configuration

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

在 GitHub 阅读完整 README →