annas-mcp

MCP сервер и CLI для поиска и загрузки книг и статей из Анны Архив прямо из агента

  • 1 119 ★ репозитория
  • Последний коммит
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Скачивает файлы из сети и пишет их на диск
  • Загрузка требует ключа API, храните его вне чатов и репозиториев
Все причины и проверки

iosifache/annas-mcp

Установка

Ручная установка

{
  "mcpServers": {
    "annas-mcp": {
      "command": "/path/to/annas-mcp",
      "args": ["mcp"],
      "env": {
        "ANNAS_SECRET_KEY": "<ваш ключ>",
        "ANNAS_DOWNLOAD_PATH": "/path/to/downloads"
      }
    }
  }
}

Ключ и путь загрузки нужны только для скачивания, поиск работает и без них.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скачивает файлы из сети и пишет их на диск
  • Загрузка требует ключа API, храните его вне чатов и репозиториев

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект дает два способа работать с Анны Архив: как MCP сервер для клиентов вроде Claude Desktop и как обычная утилита командной строки. Поиск книг и статей по названию, автору или DOI работает без ключа. Для загрузки файла нужен ключ API, который выдается после доната площадке. Есть опциональный подбор рабочего зеркала: инструмент читает публичную страницу статуса и выбирает доступное. Собран как один бинарник на Go, ставится из релизов.

Для кого. Для тех, кто ищет научные статьи и книги в открытом доступе и хочет доставать их через агента.

Подходит, если

  • Нужно найти книгу или статью по названию, автору или DOI
  • Хочется скачивать материалы командой агента, а не вручную через сайт
  • Нужен доступ к Анны Архив из Claude Desktop

Не подходит, если

  • Нет ключа API и доната, а нужна именно загрузка, а не поиск
  • Работа с материалами под копирайтом противоречит вашим правилам или закону

Пример запроса к агенту

Найди статью по DOI 10.1038/nature12345 и скачай ее в мою папку загрузок

MCP

Транспорт
stdio
Авторизация
ключ необязателен

Переменные окружения

ANNAS_SECRET_KEY секрет
Ключ API Анны Архив, нужен для загрузки файлов
ANNAS_DOWNLOAD_PATH
Папка, куда сохранять скачанные файлы
ANNAS_BASE_URL
Зеркало по умолчанию, иначе annas-archive.gl
ANNAS_AUTO_BASE_URL
Значение true включает автоподбор доступного зеркала

Ограничения

Поиск бесплатный, загрузка требует ключа API и доната. Зеркала Анны Архив меняются и бывают недоступны, доступность из России без VPN не гарантирована. Лицензия в репозитории не указана. Ответственность за соблюдение авторских прав на стороне пользователя.

Как отключить. Удалите запись annas-mcp из конфигурации MCP клиента и уберите скачанный бинарник.

Частые вопросы

Нужен ли ключ для поиска?

Нет, поиск книг и статей работает без ключа. Ключ API нужен только для загрузки файлов и выдается после доната.

Можно ли пользоваться без MCP?

Да, тот же бинарник работает как CLI: команды book-search, book-download, article-search, article-download.

Чем annas-mcp отличается от поиска книг в браузере?

Проект работает как MCP-сервер для клиентов вроде Claude Desktop и как обычная утилита командной строки. Поиск книг и статей по названию, автору или DOI идет прямо из агента.

Нужен ли ключ для поиска в annas-mcp?

Поиск по названию, автору и DOI работает без ключа. Скачивание файлов зависит от настроек сервиса и может потребовать ключ. Сервер подключается к Claude Desktop, подробности в блоке установки. Соблюдайте законы об авторском праве вашей страны.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Локальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем

MCP-серверРасширенный доступ3,3 тыс.Звезды репозитория

MCP-сервер для научной работы: поиск в arXiv и ACL Anthology, цитирования Semantic Scholar, чтение PDF и сборка LaTeX

MCP-серверРасширенный доступ94Звезды репозитория

Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными

MCP-серверРасширенный доступ1,3 тыс.Звезды репозитория

MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы

MCP-серверРасширенный доступ171Звезды репозитория

MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown

MCP-серверРасширенный доступ397Звезды репозитория

Коротко о README

README описывает установку из релизов, настройку MCP для Claude Desktop и переменные окружения. Поиск доступен сразу, загрузка требует ключа API и доната. Отдельный раздел про выбор зеркала: переменная ANNAS_AUTO_BASE_URL включает автоматический подбор доступного зеркала через страницу статуса SLUM, иначе используется ANNAS_BASE_URL. Есть таблица операций для MCP и CLI и настройка таймаутов.

Бейдж для README

Сообщить о проблеме