안나의 아카이브에서 문서(책 및 기사)를 검색하고 다운로드할 수 있는 MCP 서버 및 CLI 도구로, SLUM에서 정상으로 보고된 미러를 자동으로 선택할 수 있는 선택적 기능이 있습니다.

[! 참고] 안나의 아카이브에 대한 대중의 여론에도 불구하고, 이 플랫폼은 허용 라이선스 프레임워크 하에 공개된 문서(크리에이티브 커먼즈 출판물 및 퍼블릭 도메인 자료 포함)를 자동으로 검색하는 포괄적인 저장소 역할을 합니다. 이 소프트웨어는 저작권 콘텐츠의 무단 취득을 지지하지 않으며, 단지 유틸리티로 간주되어야 합니다. 사용자들은 저자의 지적 재산권을 존중하고 문서 제작에 투자된 상당한 노력을 인정할 것을 권장합니다.

[! 경고] 만약 링크 중 일부가 작동하지 않는 안나의 아카이브 서버로 연결된다면 미러 셀렉션을 참고해 주세요.

요구 사항

검색은 필요한 환경 변수 없이도 작동합니다.

다운로드에는 다음이 필요합니다:

• JSON API 접근 권한을 부여하는 안나스 아카이브에 기부하는
• API 키
• 프로젝트를 MCP 서버로 사용할 경우 Claude Desktop과 같은 MCP 클라이언트

준비

GitHub Releases 섹션에서 적절한 바이너리를 다운로드하세요.

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.