MCP 生态扩展：将 Anna's Archive 接入 LLM

一个用于搜索和下载 Anna's Archive 文档的 MCP 服务器

用于搜索和下载来自 Anna's Archive 的文档（书籍和文章）的 MCP 服务器和 CLI 工具，支持可选的自动选择由 SLUM 报告为健康的镜像。

尽管公众对 Anna's Archive 的看法不一，但该平台是一个综合存储库，用于自动检索在宽松许可框架下发布的文档（包括知识共享出版物和公共领域材料）。本软件不认可未经授权获取受版权保护内容，应仅视为一个工具。用户应当尊重作者的知识产权，并承认文档创作所付出的巨大努力。

如果任何链接指向非功能性的 Anna's Archive 服务器，请参考镜像选择部分。

搜索功能无需任何必需的环境变量。

向 Anna's Archive 捐款即可获得 JSON API 访问权限

一个 MCP 客户端，例如 Claude Desktop（如果将本项目用作 MCP 服务器）

从 GitHub Releases 部分下载相应的二进制文件。

如果计划使用该工具的 MCP 服务器功能，需要将其集成到 MCP 客户端中。如果使用的是 Claude Desktop，请参考以下示例配置：

"anna-mcp": {
    "command": "/Users/iosifache/Downloads/annas-mcp",
    "args": ["mcp"],
    "env": {
        "ANNAS_SECRET_KEY": "feedfacecafebeef",
        "ANNAS_DOWNLOAD_PATH": "/Users/iosifache/Downloads",
        "ANNAS_BASE_URL": "annas-archive.gl"
    }
}

该工具可通过环境变量进行配置。这些变量也可存储在包含二进制文件的文件夹内的 .env 文件中。

下载环境变量

ANNAS_SECRET_KEY：Anna's Archive API 密钥。

ANNAS_DOWNLOAD_PATH：文档应下载到的路径。

Anna's Archive 有多个镜像，其可用性会随时间变化。默认情况下，该项目使用 ANNAS_BASE_URL，或当未设置 ANNAS_BASE_URL 时使用 annas-archive.gl。

可选配置

或者，可以设置：

ANNAS_BASE_URL：要使用的 Anna 镜像（默认为 annas-archive.gl）。启用自动镜像发现后，此项成为备用镜像。

ANNAS_AUTO_BASE_URL：设置为 true 以从 SLUM 自动发现最优可用的 Anna 镜像。

自动发现是可选的：当 ANNAS_AUTO_BASE_URL=true 时，工具会读取公共状态页面，根据最近的健康状况和延迟对已发现的 Anna 镜像候选进行排名，对其进行本地探测，并使用最佳可达的镜像。若发现或探测失败，工具将回退到 ANNAS_BASE_URL，再次不可用时回退到内置默认镜像。

HTTP 请求的默认超时时间为 1 小时。对于 CLI 使用，可通过 --timeout 参数覆盖此设置，例如：

annas-mcp --timeout 1h book-download abc123def456 "my-book.pdf"

对于 MCP 使用，工具接受可选的 timeout_seconds 参数，例如 3600 表示 1 小时。