/ Каталог / Песочница / annas-mcp
● Сообщество iosifache ⚡ Сразу

annas-mcp

автор 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.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

annas.replay ▶ готово
0/0

Установка

Выберите клиент

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

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

Continue использует массив объектов серверов, а не map.

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

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: annas-mcp

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

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

Когда использовать: You need a specific paper by DOI or want to explore articles on a topic.

Предварительные требования
  • 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
Поток
  1. Search for the article
    Search Anna's Archive for articles about 'transformer attention mechanisms' published after 2020.✓ Скопировано
    → List of matching articles with titles, authors, and DOIs
  2. Download the paper
    Download the first result to my papers folder.✓ Скопировано
    → File saved confirmation with path

Итог: PDF of the requested paper saved locally.

Подводные камни
  • API key not set — Ensure ANNAS_SECRET_KEY is set in your environment before starting the MCP server
Сочетать с: filesystem

Build a reading list on a topic using annas-mcp

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

Когда использовать: You want to compile a list of relevant books on a subject.

Предварительные требования
  • Anna's Archive API key — Donate at annas-archive.li
Поток
  1. Search for books
    Search for books about 'distributed systems' and list the top 10 results with authors and publication years.✓ Скопировано
    → Formatted list of books with metadata
  2. Download selected titles
    Download books 1, 3, and 7 from the list.✓ Скопировано
    → Three files saved with confirmation

Итог: A curated set of downloaded books on the chosen topic.

Подводные камни
  • Download fails with certain mirrors — Set ANNAS_BASE_URL to a different mirror if the default is unreachable
Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект 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/.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
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

Стоимость и лимиты

Во что обходится

Квота API
Rate limits depend on your Anna's Archive API tier
Токенов на вызов
200–500 tokens per search, more for downloads
Деньги
Requires donation to Anna's Archive for API access
Совет
Use search first to identify exactly what you want before downloading to avoid unnecessary API calls.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: API key stored in ANNAS_SECRET_KEY environment variable
Исходящий трафик: Calls to Anna's Archive API (configurable mirror URL)

Устранение неполадок

Частые ошибки и исправления

401 Unauthorized

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

Проверить: echo $ANNAS_SECRET_KEY
Connection refused / timeout

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

Проверить: 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.

Альтернативы

annas-mcp в сравнении

АльтернативаКогда использоватьКомпромисс
fetch MCPYou just need to grab a specific URL or DOI link directlyNo structured search — you need to know the exact URL

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills