freemcplab / Verzeichnis / Playground / annas-mcp

● Community iosifache ⚡ Sofort

annas-mcp

Name: annas-mcp MCP Server
Author: iosifache

Search and download books and academic articles from Anna's Archive directly through your AI assistant.

annas-mcp provides an MCP server and CLI for searching and downloading documents from Anna's Archive. It supports book search by title/author/topic, article search by DOI or keyword, and direct downloads. Written in Go with pre-built binaries for all platforms. Requires an Anna's Archive API key obtained via donation.

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

Search books by title, author, or topic across Anna's Archive
Search and download academic articles by DOI or keyword
Direct document downloads via MD5 hash identifiers
Supports multiple Anna's Archive mirror URLs for reliability
Dual interface — works as MCP server or standalone CLI

Live-Demo

In der Praxis

annas.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "annas",
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "annas": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/iosifache/annas-mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add annas -- TODO 'See README: https://github.com/iosifache/annas-mcp'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: annas-mcp

How to find and download a research paper with annas-mcp

👤 Researchers and students needing access to academic literature ⏱ ~5 min beginner

Wann einsetzen: You need a specific paper by DOI or want to explore articles on a topic.

Voraussetzungen

Anna's Archive API key — Donate at annas-archive.li to receive your API key
ANNAS_SECRET_KEY env var set — export ANNAS_SECRET_KEY=your_key

Ablauf

Search for the article

Search Anna's Archive for articles about 'transformer attention mechanisms' published after 2020.✓ Kopiert

→ List of matching articles with titles, authors, and DOIs
Download the paper

Download the first result to my papers folder.✓ Kopiert

→ File saved confirmation with path

Ergebnis: PDF of the requested paper saved locally.

Fallstricke

API key not set — Ensure ANNAS_SECRET_KEY is set in your environment before starting the MCP server

Kombinieren mit: filesystem

Build a reading list on a topic using annas-mcp

👤 Anyone curating books or papers for study ⏱ ~10 min beginner

Wann einsetzen: You want to compile a list of relevant books on a subject.

Voraussetzungen

Anna's Archive API key — Donate at annas-archive.li

Ablauf

Search for books

Search for books about 'distributed systems' and list the top 10 results with authors and publication years.✓ Kopiert

→ Formatted list of books with metadata
Download selected titles

Download books 1, 3, and 7 from the list.✓ Kopiert

→ Three files saved with confirmation

Ergebnis: A curated set of downloaded books on the chosen topic.

Fallstricke

Download fails with certain mirrors — Set ANNAS_BASE_URL to a different mirror if the default is unreachable

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

annas + filesystem

Download papers and organize them into topic-based folders automatically

Search for papers on 'reinforcement learning from human feedback', download the top 5, and organize them into ~/papers/rlhf/.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
book_search	query: str	Search for books by title, author, or topic	1 API call
book_download	md5: str	Download a book using its MD5 identifier from search results	1 API call
article_search	query: str	Find articles by DOI or keyword	1 API call
article_download	doi: str	Download an article by its DOI	1 API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Rate limits depend on your Anna's Archive API tier
Tokens pro Aufruf: 200–500 tokens per search, more for downloads
Kosten in €: Requires donation to Anna's Archive for API access
Tipp: Use search first to identify exactly what you want before downloading to avoid unnecessary API calls.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: API key stored in ANNAS_SECRET_KEY environment variable

Datenabfluss: Calls to Anna's Archive API (configurable mirror URL)

Ensure downloaded content complies with your local copyright laws. Anna's Archive hosts Creative Commons and public domain works alongside other materials.

Fehlerbehebung

Häufige Fehler und Lösungen

401 Unauthorized

Your ANNAS_SECRET_KEY is missing or invalid. Verify it's set correctly in your environment.

Prüfen: echo $ANNAS_SECRET_KEY

Connection refused / timeout

The default mirror may be down. Set ANNAS_BASE_URL to an alternative mirror.

Prüfen: curl https://annas-archive.li

No results found

Try broader search terms or different keywords. Book searches work best with exact titles or author names.

Alternativen

annas-mcp vs. andere

Alternative	Wann stattdessen	Kompromiss
fetch MCP	You just need to grab a specific URL or DOI link directly	No structured search — you need to know the exact URL

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen