文档搜索下载工具

Anna的存档MCP服务器（和CLI工具）

MCP服务器 以及用于搜索和下载文档（书籍和文章）的CLI工具 安娜的档案，可选择自动选择由报告为健康的镜像 贫民窟.

[！注意] 尽管公众对Anna's Archive普遍持有看法，但该平台是一个全面的存储库，用于自动检索在许可框架下发布的文档（包括知识共享出版物和公共领域材料）。本软件不支持未经授权获取受版权保护的内容，应仅视为实用程序。我们敦促用户尊重作者的知识产权，并认可他们在文档创建方面所付出的巨大努力。

[！警告] 请参考 镜像选择 如果任何链接指向无法正常工作的Anna's Archive服务器。

需求

搜索工作不需要任何必需的环境变量。

下载需要：

• 捐赠给安娜档案馆，授予JSON API访问权限
• API密钥
• MCP客户端，例如 克劳德桌面，如果将项目用作MCP服务器

设置

从下载相应的二进制文件 GitHub发布部分.

如果您计划将该工具用于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：安娜档案馆API密钥。
• ANNAS_DOWNLOAD_PATH：应下载文档的路径。

镜像选择

Anna's Archive有多个镜像，它们的可用性会随着时间的推移而变化。默认情况下，此项目使用 ANNAS_BASE_URL，或 annas-archive.gl 当 ANNAS_BASE_URL 未设置。

您可以选择设置：

• ANNAS_BASE_URL：要使用的Anna镜像（默认为 annas-archive.gl).启用自动镜像发现后，这将成为回退镜像。
• ANNAS_AUTO_BASE_URL：设置为 true 从中自动发现最佳可用的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小时。

演示

作为MCP服务器

作为CLI工具

可用操作