Academic Archive Gateway

专为 AI 助手（Codex、Claude Desktop 等）设计的本地 MCP 插件，用于检索和下载电子书。

一键安装

前提： 需要 Python 3.12+，以及一个免费的 Z-Library 账号。

1. 把整个文件夹放到一个固定位置（不要放在临时目录）
2. macOS 双击 一键安装.command，Windows 双击 一键安装.bat
3. 按提示输入 Z-Library 邮箱和密码
4. 脚本会自动创建虚拟环境、安装依赖、配置 Codex

完成后打开 Codex 即可使用。

手动配置

如果不用一键安装脚本，按以下步骤操作：

1. 创建虚拟环境

cd academic-archive-gateway
python3.12 -m venv venv
venv/bin/pip install fastmcp httpx playwright beautifulsoup4 pydantic python-dotenv
venv/bin/playwright install chromium

2. 配置 MCP

Codex CLI — 编辑 ~/.codex/config.toml：

[mcp_servers.academic-gateway]
command = "/你的路径/academic-archive-gateway/venv/bin/python3"
args = ["/你的路径/academic-archive-gateway/stealth_mcp.py"]
[mcp_servers.academic-gateway.env]
ARCHIVE_USER = "你的邮箱"
ARCHIVE_TOKEN = "你的密码"
ANNAS_BASE_URL = "https://annas-archive.gl"

Codex GUI — 在自定义 MCP 配置界面填写：

字段	内容
名称	academic-gateway
协议	STDIO
启动命令	/你的路径/academic-archive-gateway/venv/bin/python3
参数	/你的路径/academic-archive-gateway/stealth_mcp.py
环境变量 ARCHIVE_USER	你的 Z-Library 邮箱
环境变量 ARCHIVE_TOKEN	你的 Z-Library 密码
环境变量 ANNAS_BASE_URL	https://annas-archive.gl

QoderWork — 编辑 ~/.qoderworkcn/mcp.json：

{
  "mcpServers": {
    "academic-gateway": {
      "command": "/你的路径/academic-archive-gateway/venv/bin/python3",
      "args": ["/你的路径/academic-archive-gateway/stealth_mcp.py"],
      "env": {
        "ARCHIVE_USER": "你的邮箱",
        "ARCHIVE_TOKEN": "你的密码",
        "ANNAS_BASE_URL": "https://annas-archive.gl"
      },
      "enabled": true
    }
  }
}

使用方式

对 AI 说：

"用学术档案网关帮我搜索《Evicted》"

AI 会自动搜索并把书下载到桌面 Archival_Documents 文件夹。

可用工具

• search_academic_literature — 搜索书籍（返回书名、作者、格式、大小、download_path）
• fetch_archival_document — 下载书籍（传入 archival_id 和 download_path）
• search_annas_archive — 备用搜索（Anna's Archive）
• fetch_annas_document — 备用下载

注意事项

• Z-Library 免费账号每天限 10 次下载
• 下载路径固定为 ~/Desktop/Archival_Documents/
• 代理：安装脚本会询问是否需要代理。也可通过 PROXY_URL 环境变量手动设置（如 http://127.0.0.1:7890）。不设则直连。
• 浏览器路径：默认自动检测。仅 macOS ARM64 遇到 "进程被杀" 问题时需手动通过 CHROMIUM_PATH 环境变量指定完整 Chrome 路径。
• Anna's Archive 镜像地址可通过 ANNAS_BASE_URL 环境变量切换