annas-mcp
MCP сервер и CLI для поиска и загрузки книг и статей из Анны Архив прямо из агента
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Скачивает файлы из сети и пишет их на диск
- Загрузка требует ключа API, храните его вне чатов и репозиториев
Установка
Ручная установка
{
"mcpServers": {
"annas-mcp": {
"command": "/path/to/annas-mcp",
"args": ["mcp"],
"env": {
"ANNAS_SECRET_KEY": "<ваш ключ>",
"ANNAS_DOWNLOAD_PATH": "/path/to/downloads"
}
}
}
}Ключ и путь загрузки нужны только для скачивания, поиск работает и без них.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает два способа работать с Анны Архив: как MCP сервер для клиентов вроде Claude Desktop и как обычная утилита командной строки. Поиск книг и статей по названию, автору или DOI работает без ключа. Для загрузки файла нужен ключ API, который выдается после доната площадке. Есть опциональный подбор рабочего зеркала: инструмент читает публичную страницу статуса и выбирает доступное. Собран как один бинарник на Go, ставится из релизов.
Для кого. Для тех, кто ищет научные статьи и книги в открытом доступе и хочет доставать их через агента.
Подходит, если
- Нужно найти книгу или статью по названию, автору или DOI
- Хочется скачивать материалы командой агента, а не вручную через сайт
- Нужен доступ к Анны Архив из Claude Desktop
Не подходит, если
- Нет ключа API и доната, а нужна именно загрузка, а не поиск
- Работа с материалами под копирайтом противоречит вашим правилам или закону
Пример запроса к агенту
Найди статью по DOI 10.1038/nature12345 и скачай ее в мою папку загрузокОграничения
Поиск бесплатный, загрузка требует ключа API и доната. Зеркала Анны Архив меняются и бывают недоступны, доступность из России без VPN не гарантирована. Лицензия в репозитории не указана. Ответственность за соблюдение авторских прав на стороне пользователя.
Как отключить. Удалите запись annas-mcp из конфигурации MCP клиента и уберите скачанный бинарник.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ANNAS_SECRET_KEY секрет | Ключ API Анны Архив, нужен для загрузки файлов |
| ANNAS_DOWNLOAD_PATH | Папка, куда сохранять скачанные файлы |
| ANNAS_BASE_URL | Зеркало по умолчанию, иначе annas-archive.gl |
| ANNAS_AUTO_BASE_URL | Значение true включает автоподбор доступного зеркала |
Проверка безопасности
- Скачивает файлы из сети и пишет их на диск
- Загрузка требует ключа API, храните его вне чатов и репозиториев
Коротко о README
README описывает установку из релизов, настройку MCP для Claude Desktop и переменные окружения. Поиск доступен сразу, загрузка требует ключа API и доната. Отдельный раздел про выбор зеркала: переменная ANNAS_AUTO_BASE_URL включает автоматический подбор доступного зеркала через страницу статуса SLUM, иначе используется ANNAS_BASE_URL. Есть таблица операций для MCP и CLI и настройка таймаутов.
Частые вопросы
Нужен ли ключ для поиска?
Нет, поиск книг и статей работает без ключа. Ключ API нужен только для загрузки файлов и выдается после доната.
Можно ли пользоваться без MCP?
Да, тот же бинарник работает как CLI: команды book-search, book-download, article-search, article-download.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов