Annas MCP

## 🚀 Anna's Archive MCP Server (and CLI Tool)

*An MCP server and CLI tool for searching and downloading documents from Anna's Archive. It enables users to access a wide - range of documents released under permissive licensing frameworks.*

> ⚠️ **Important 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.

## 🚀 Quick Start

### ✨ Features
#### Available Operations
| Property | Details |
|----------|---------|
| Search for documents | Use the `search` operation in the MCP tool or CLI command to search Anna's Archive for documents matching specified terms. |
| Download documents | After getting search results, use the `download` operation in the MCP tool or CLI command to download a specific document. |

## 📦 Installation
### Requirements
- **For CLI tool only**:
    - [A donation to Anna's Archive](https://annas-archive.org/donate), which grants JSON API access
    - [An API key](https://annas-archive.org/faq#api)
- **For MCP server usage**: An MCP client, such as [Claude Desktop](https://claude.ai/download)

The environment should contain two variables:
- `ANNAS_SECRET_KEY`: The API key
- `ANNAS_DOWNLOAD_PATH`: The path where the documents should be downloaded

### Setup
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:

```json
"anna-mcp": {
    "command": "/Users/iosifache/Downloads/annas-mcp",
    "args": ["mcp"],
    "env": {
        "ANNAS_SECRET_KEY": "feedfacecafebeef",
        "ANNAS_DOWNLOAD_PATH": "/Users/iosifache/Downloads"
    }
}

💻 Usage Examples

As an MCP Server

As a CLI Tool