Annas MCP Server

Anna's Archive document searching and retrieval through an MCP server interface.

Data last scanned today · Reviewed today

Overview

Annas MCP Server provides a specialized gateway for accessing Anna's Archive directly from AI assistants. The tool supports searching for documents, articles, and books, offering an automated way to retrieve specific resources using the platform's API. It functions as both a standalone CLI tool and an MCP server, integrating into local environments via environment variables. Users can manage mirror selection manually or enable automatic discovery using SLUM for improved connectivity to the repository.

Our verdict

This server carries a high-risk score of 35/100, primarily due to the lack of an identified software license and the fact that it is a community-maintained project rather than an official offering. Given these concerns and the absence of an editorial review of its authentication or read-only modes, users should approach this tool with caution and verify the source code before deployment, particularly in sensitive or regulated environments.

  • Zero direct dependencies reduce potential supply-chain vulnerabilities.
  • Integrated support for automatic mirror discovery via SLUM.
  • Dual-mode functionality as both CLI tool and MCP server.
  • Comprehensive documentation provided for configuration and setup.
  • Unclear legal terms for use due to no license detected.
  • High-risk security score reflecting lack of formal maintenance.
  • Authentication mechanisms remain unreviewed by external security audits.

Tools

ToolDescriptionRisk
book_searchSearch for books by title, author, or topiclow
book_downloadDownload a book by its MD5 hashmedium
article_searchSearch for articles by DOI or keywordslow
article_downloadDownload an article by its DOImedium

Compatibility

ClientLocalDockerRemoteRead-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

Are there prerequisites to download documents?

Yes, you must provide a donation to Anna's Archive to obtain an API key, which is required for downloading documents.

How can I configure the server to automatically select a mirror?

You can enable automatic mirror discovery by setting the ANNAS_AUTO_BASE_URL environment variable to true, which ranks mirrors based on health and latency using SLUM.

Can I store configuration variables in a file instead of environment variables?

Yes, configuration environment variables can be stored in an .env file located in the same directory as the server binary.

What happens if automatic mirror discovery fails?

If automatic discovery or local probing fails, the tool falls back to the mirror specified in ANNAS_BASE_URL, or the built-in default if that is not set.

Can I adjust the request timeout for MCP operations?

Yes, you can specify an optional timeout_seconds parameter when calling the MCP tools, such as setting it to 3600 for a one-hour duration.

Alternatives

Changelog

Badge

Annas MCP Server security score, rated on RepoAI

Maintain this server? Add the live badge to your README.