annas-mcp
MCP сервер и CLI для поиска и загрузки книг и статей из Анны Архив прямо из агента
- 1 119 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скачивает файлы из сети и пишет их на диск
- Загрузка требует ключа API, храните его вне чатов и репозиториев
Установка
- Работает в
Ручная установка
{
"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 из метаданных, отслеживание тем
Academia MCP — поиск научных статей
Academia MCP
MCP-сервер для научной работы: поиск в arXiv и ACL Anthology, цитирования Semantic Scholar, чтение PDF и сборка LaTeX
CLI и MCP-сервер для библиотеки научных статей: агент ищет, импортирует и читает статьи, ведет заметки Markdown в вашем хранилище
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
Коротко о README
README описывает установку из релизов, настройку MCP для Claude Desktop и переменные окружения. Поиск доступен сразу, загрузка требует ключа API и доната. Отдельный раздел про выбор зеркала: переменная ANNAS_AUTO_BASE_URL включает автоматический подбор доступного зеркала через страницу статуса SLUM, иначе используется ANNAS_BASE_URL. Есть таблица операций для MCP и CLI и настройка таймаутов.