Anna’s Archiveから文書(書籍や記事)を検索・ダウンロードするためのMCPサーバーおよびCLIツールで、SLUMによって健康と報告されたミラーの自動選択がオプションで可能となります。

[!注] アンナのアーカイブに関する世論が広まっているにもかかわらず、このプラットフォームは寛容なライセンス枠組みの下で公開された文書(クリエイティブ・コモンズ出版物やパブリックドメイン資料を含む)を自動取得するための包括的なリポジトリとして機能しています。このソフトウェアは著作権で保護されたコンテンツの無断取得を推奨するものではなく、あくまでユーティリティとして扱うべきです。利用者は著者の知的財産権を尊重し、文書作成に注がれている多大な労力を認識するよう促されています。

[!警告] リンクの中に機能していないアンナのアーカイブサーバーに繋がっている場合は、ミラーセレクションを参照してください。

要件

検索は必要な環境変数なしで動作します。

ダウンロードには以下が必要です:

• JSONのAPIアクセス権を与えるアンナのアーカイブへの寄付
• APIキー
• プロジェクトをMCPサーバーとして使用する場合、Claude DesktopのようなMCPクライアント

セットアップ

GitHubのリリースセクションから適切なバイナリをダウンロードしてください。

Anna’s Archive MCP Server (and CLI Tool)

An MCP server and CLI tool for searching and downloading documents (books and articles) from Anna’s Archive, with optional automatic selection of a mirror reported as healthy by SLUM.

[!NOTE] Notwithstanding prevailing public sentiment regarding Anna’s Archive, the platform serves as a comprehensive repository for automated retrieval of documents released under permissive licensing frameworks (including Creative Commons publications and public domain materials). This software does not endorse unauthorized acquisition of copyrighted content and should be regarded solely as a utility. Users are urged to respect the intellectual property rights of authors and acknowledge the considerable effort invested in document creation.

[!WARNING] Please refer to Mirror Selection if any of the links lead to a non-functional Anna’s Archive server.

Requirements

Search works without any required environment variables.

Downloads require:

• A donation to Anna’s Archive, which grants JSON API access
• An API key
• An MCP client, such as Claude Desktop, if using the project as an MCP server

Setup

Download the appropriate binary from the GitHub Releases section.

If you plan to use the tool for its MCP server functionality, you need to integrate it into your MCP client. If you are using Claude Desktop, please consider the following example configuration:

"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"
    }
}

Configuration

The tool can be configured with environment variables. These variables can also be stored in an .env file in the folder containing the binary.

Download Environment Variables

Downloads use:

• ANNAS_SECRET_KEY: The Anna’s Archive API key.
• ANNAS_DOWNLOAD_PATH: The path where the documents should be downloaded.

Mirror Selection

Anna’s Archive has multiple mirrors, and their availability can change over time. By default, this project uses ANNAS_BASE_URL, or annas-archive.gl when ANNAS_BASE_URL is not set.

Optionally, you can set:

• ANNAS_BASE_URL: The Anna mirror to use (defaults to annas-archive.gl). When automatic mirror discovery is enabled, this becomes the fallback mirror.
• ANNAS_AUTO_BASE_URL: Set to true to discover the best available Anna mirror automatically from SLUM.