/ Annuaire / Playground / annas-mcp
← Tous les serveurs ↗ GitHub
● Communauté iosifache ⚡ Instantané

annas-mcp

par iosifache · iosifache/annas-mcp

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.

▶ Voir la démo 📦 Installer 💡 Cas d'usage

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

annas.replay ▶ prêt
0/0

Installer

Choisissez votre 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
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "annas": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/iosifache/annas-mcp"
      ],
      "_inferred": true
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : annas-mcp

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

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

Quand l'utiliser : You need a specific paper by DOI or want to explore articles on a topic.

Prérequis
  • 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
Déroulement
  1. Search for the article
    Search Anna's Archive for articles about 'transformer attention mechanisms' published after 2020.✓ Copié
    → List of matching articles with titles, authors, and DOIs
  2. Download the paper
    Download the first result to my papers folder.✓ Copié
    → File saved confirmation with path

Résultat : PDF of the requested paper saved locally.

Pièges
  • API key not set — Ensure ANNAS_SECRET_KEY is set in your environment before starting the MCP server
Combiner avec : filesystem

Build a reading list on a topic using annas-mcp

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

Quand l'utiliser : You want to compile a list of relevant books on a subject.

Prérequis
  • Anna's Archive API key — Donate at annas-archive.li
Déroulement
  1. Search for books
    Search for books about 'distributed systems' and list the top 10 results with authors and publication years.✓ Copié
    → Formatted list of books with metadata
  2. Download selected titles
    Download books 1, 3, and 7 from the list.✓ Copié
    → Three files saved with confirmation

Résultat : A curated set of downloaded books on the chosen topic.

Pièges
  • Download fails with certain mirrors — Set ANNAS_BASE_URL to a different mirror if the default is unreachable
Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

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/.✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
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

Coût et limites

Coût d'exécution

Quota d'API
Rate limits depend on your Anna's Archive API tier
Tokens par appel
200–500 tokens per search, more for downloads
Monétaire
Requires donation to Anna's Archive for API access
Astuce
Use search first to identify exactly what you want before downloading to avoid unnecessary API calls.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : API key stored in ANNAS_SECRET_KEY environment variable
Sortie de données : Calls to Anna's Archive API (configurable mirror URL)

Dépannage

Erreurs courantes et correctifs

401 Unauthorized

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

Vérifier : echo $ANNAS_SECRET_KEY
Connection refused / timeout

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

Vérifier : 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.

Alternatives

annas-mcp vs autres

AlternativeQuand l'utiliserCompromis
fetch MCPYou just need to grab a specific URL or DOI link directlyNo structured search — you need to know the exact URL

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills