freemcplab / Diretório / Playground / annas-mcp

● Comunidade iosifache ⚡ Instantâneo

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.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

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

Demo ao vivo

Como fica na prática

annas.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/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
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: annas-mcp

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

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

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

Pré-requisitos

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

Fluxo

Search for the article

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

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

Download the first result to my papers folder.✓ Copiado

→ File saved confirmation with path

Resultado: PDF of the requested paper saved locally.

Armadilhas

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

Combine com: filesystem

Build a reading list on a topic using annas-mcp

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

Quando usar: You want to compile a list of relevant books on a subject.

Pré-requisitos

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

Fluxo

Search for books

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

→ Formatted list of books with metadata
Download selected titles

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

→ Three files saved with confirmation

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

Armadilhas

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

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

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/.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
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

Custo e limites

O que custa rodar

Cota de API: Rate limits depend on your Anna's Archive API tier
Tokens por chamada: 200–500 tokens per search, more for downloads
Monetário: Requires donation to Anna's Archive for API access
Dica: Use search first to identify exactly what you want before downloading to avoid unnecessary API calls.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: API key stored in ANNAS_SECRET_KEY environment variable

Saída de dados: 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.

Solução de problemas

Erros comuns e correções

401 Unauthorized

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

Verificar: echo $ANNAS_SECRET_KEY

Connection refused / timeout

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

Verificar: 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.

Alternativas

annas-mcp vs. outros

Alternativa	Quando usar	Troca
fetch MCP	You just need to grab a specific URL or DOI link directly	No structured search — you need to know the exact URL

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills