iosifache

annas-mcp: Search and Download Documents from Anna's Archive

A Go CLI and MCP server for searching books and articles and downloading them from Anna's Archive. Search needs no credentials, but downloads require an Anna's Archive API key.

View on GitHub Compare
Stars
1.1k
Forks
71
Stars, last 30 days
+41
Last commit
3 months ago
Contributors
3

Our take

Quietno commits in the last 90 days

Health score

29/100

How it is scored
Activity
37
Community
18
Issues
42
Pull requests
20

+41 stars in the last 30 days

  • Fewer contributors than 82% of the projects we track

This is a focused, recently released Go utility with active release history but a quiet recent development period and work concentrated in one contributor.

Good fit if

  • You need Anna's Archive search through a CLI or MCP client, and understand that downloads require a donation-backed API key.
  • You can work with a Go 1.23.4-based project and are comfortable configuring environment variables for downloads.
  • You want a tool with several releases in the past year and recent issue closures, while accepting that most contributions come from one person.

Look elsewhere if

  • You need document downloads without Anna's Archive API access.
  • Your project requires a clearly stated license, since none is specified in the provided repository data.
  • You require ongoing recent commits or a test suite; the project has had no commits in the last 90 days, and the provided health data reports no tests.
All health signals
Last commit2026-06-26 (3 months ago)
Commits, last 90 days0
Releases, last 12 months5 (latest v0.1, 2026-06-26)
Contributors3 (top contributor: 94% of commits)
Issues closed, last 90 days4 (typically closed in 37 days)
Project age15 months

Checked on 2026-10-07 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

1,127

Forks

73

Change since Nov 16, 2026: +1 stars·0 forks

Overview

annas-mcp lets people search Anna's Archive for books and articles, then use CLI commands or MCP tools to retrieve selected documents. It connects document discovery to MCP clients such as Claude Desktop, or can be used directly from a terminal.

It suits users who already rely on Anna's Archive and want to make its search and download operations available in scripts or an MCP-enabled assistant. Search works without credentials; downloads require API access.

Key Features

  • Search for books by title, author, or topic through the CLI or the book_search MCP tool.
  • Search for articles using a DOI or keywords.
  • Download a book using its MD5 hash or an article using its DOI.
  • Configure the download directory and Anna's Archive API key with environment variables.
  • Choose a mirror with ANNAS_BASE_URL, or opt into automatic mirror discovery using SLUM's public status page.
  • Set request timeouts for CLI commands or MCP tool calls.
  • Run as a standalone CLI or connect it to an MCP client.

Use Cases

  • A reader looking for a specific book or article can search by title, author, topic, DOI, or keywords, then download it if they have API access.
  • A user of an MCP client can let an assistant search the archive and request documents through the provided tools.
  • A developer can script searches and downloads from a terminal without building a separate Anna's Archive integration.
  • Someone encountering an unavailable default mirror can enable automatic discovery or configure a different mirror.

What you need

Detected in the repository

  • Go 1.23.4 or newer (from go.mod)
  • Automated checks on GitHub Actions

Getting Started

Download a binary from the GitHub Releases page. To start its MCP server, configure your MCP client to run the binary with the mcp argument. For setup and CLI examples, see the README.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Considerations

Downloads depend on access to Anna's Archive's JSON API, which requires a donation and API key; search does not. Mirror availability can change, and automatic discovery is opt-in. The project has had no commits in the last 90 days, although it has published releases during the past year and closed issues recently. Development is concentrated in one of three contributors, and the provided health data reports no test suite. No license is specified in the repository data, so verify licensing before adopting or redistributing it. Users should also respect authors' intellectual property rights and applicable permissions when retrieving documents.

Found this useful?

Share it with someone who would like annas-mcp.