Skip to content
Back to search

annas-mcp

MCP server and CLI tool for searching and downloading documents from Anna's Archive

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/iosifache--annas-mcp/badge.svg)](/listings/iosifache--annas-mcp)

HTML

<a href="/listings/iosifache--annas-mcp"><img src="/api/listings/iosifache--annas-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Download the appropriate binary from [the GitHub Releases section](https://github.com/iosifache/annas-mcp/releases).

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 88 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Anna's Archive MCP Server (and CLI Tool)
  2. [An MCP server](https://modelcontextprotocol.io/introduction) and CLI tool for searching and downloading documents (books and articles) from [Anna's Archive](https://annas-archive.gl), with optional automatic selection of a mirror reported as healthy by [SLUM](https://open-slum.org/).
  3. > [!NOTE]
  4. > 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.
  5. > [!WARNING]
  6. > Please refer to [Mirror Selection](#mirror-selection) if any of the links lead to a non-functional Anna's Archive server.
  7. ## Requirements
  8. Search works without any required environment variables.
  9. Downloads require:
  10. - [A donation to Anna's Archive](https://annas-archive.gl/donate), which grants JSON API access
  11. - [An API key](https://annas-archive.gl/faq#api)
  12. - An MCP client, such as [Claude Desktop](https://claude.ai/download), if using the project as an MCP server
  13. ## Setup
  14. Download the appropriate binary from [the GitHub Releases section](https://github.com/iosifache/annas-mcp/releases).
  15. 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:
  16. ```json
  17. "anna-mcp": {
  18. "command": "/Users/iosifache/Downloads/annas-mcp",
  19. "args": ["mcp"],
  20. "env": {
  21. "ANNAS_SECRET_KEY": "feedfacecafebeef",
  22. "ANNAS_DOWNLOAD_PATH": "/Users/iosifache/Downloads",
  23. "ANNAS_BASE_URL": "annas-archive.gl"
  24. }
  25. }
  26. ```
  27. ## Configuration
  28. The tool can be configured with environment variables. These variables can also be stored in an `.env` file in the folder containing the binary.
  29. ### Download Environment Variables
  30. Downloads use:
  31. - `ANNAS_SECRET_KEY`: The Anna's Archive API key.
  32. - `ANNAS_DOWNLOAD_PATH`: The path where the documents should be downloaded.
  33. ### Mirror Selection
  34. 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.
  35. Optionally, you can set:
  36. - `ANNAS_BASE_URL`: The Anna mirror to use (defaults to `annas-archive.gl`). When automatic mirror discovery is enabled, this becomes the fallback mirror.
  37. - `ANNAS_AUTO_BASE_URL`: Set to `true` to discover the best available Anna mirror automatically from [SLUM](https://open-slum.org/).
  38. Automatic discovery is opt-in: when `ANNAS_AUTO_BASE_URL=true`, the tool reads the public status page, ranks discovered Anna mirror candidates by recent health and latency, probes them locally, and uses the best reachable mirror. If discovery or probing fails, the tool falls back to `ANNAS_BASE_URL`, then to the built-in default mirror.
  39. ### Timeouts
  40. HTTP requests default to a 1 hour timeout. For CLI usage, override this with `--timeout`, for example:
  41. ```bash
  42. annas-mcp --timeout 1h book-download abc123def456 "my-book.pdf"
  43. ```
  44. For MCP usage, tools accept an optional `timeout_seconds` parameter, for example `3600` for 1 hour.
  45. ## Demo
  46. ### As an MCP Server
  47. <img src="screenshots/claude.png" width="600px"/>
  48. ### As a CLI Tool
  49. <img src="screenshots/cli.png" width="400px"/>
  50. ## Available Operations
  51. | Operation | MCP Tool | CLI Command | Example |
  52. | ---------------------------------------------- | ------------------ | ------------------- | ------------------------------------------------------------ |
  53. | Search for books by title, author, or topic | `book_search` | `book-search` | `book-search "machine learning python"` |
  54. | Download a book by its MD5 hash | `book_download` | `book-download` | `book-download abc123def456 "my-book.pdf"` |
  55. | Search for articles by DOI or keywords | `article_search` | `article-search` | `article-search "10.1038/nature12345"` or `article-search "neural networks"` |
  56. | Download an article by its DOI | `article_download` | `article-download` | `article-download "10.1038/nature12345"` |

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.