blazickjp/arxiv-mcp-server

Проверяет все сохранённые отслеживания тем на наличие новых опубликованных статей с момента последней проверки. Пропуск параметра topic запускает ВСЕ сохранённые отслеживания и возвращает новые статьи для каждого. Передача строки topic проверяет только конкретное отслеживание. После выполнения продвигает курсор опустошения (drain cursor) каждого отслеживания: когда страница обрезается параметром max_results, has_more=true, а check_start смещается так, что последующие вызовы возвращают следующие статьи в том же окне (границы дат Atom имеют дневную гранулярность и иначе снова упёрлись бы в границу); last_checked отслеживает самую новую возвращённую статью. Когда страница не заполнена, last_checked становится равным текущему моменту, а курсор опустошения сбрасывается. Используйте watch_topic для регистрации тем перед вызовом этого инструмента. Возвращает понятную ошибку «не найдено», если topic указан, но соответствующего отслеживания не существует. Возвращает сводку с количеством новых статей, has_more и полными метаданными статей по каждой теме.

Возвращает статьи, цитирующие статью arXiv, и статьи, на которые она ссылается, с помощью графа цитирования Semantic Scholar. Результаты ограничены (по умолчанию 50), чтобы не выходить за пределы квоты для неавторизованных запросов. Графы кэшируются на диске, чтобы сократить повторные вызовы API. Под нагрузкой бесплатный ключ API Semantic Scholar (https://www.semanticscholar.org/product/api#api-key) делает это надёжным; без ключа постоянные ограничения частоты запросов возвращают status=rate_limited с недвусмысленным предупреждением вместо жёсткого сбоя.

Скачивает статью с arXiv и возвращает её текстовое содержание. Сначала пробует HTML-версию для чистого извлечения; при недоступности HTML переключается на преобразование из PDF. Сохраняет статью локально. Возвращаемый текст по умолчанию ограничен примерно 12 000 символов, чтобы один вызов не мог вернуть неограниченное тело статьи. Когда is_truncated равен true, вызовите снова с параметром start=next_start (см. next_retrieval), чтобы продолжить, или передайте return_full_text=true для получения всего оставшегося текста статьи. Установите force=true, чтобы повторно загрузить и перезаписать кэшированную статью (требуется для замены более новой сохранённой версии arXiv на более старую).

Экспортирует ссылки BibTeX для одной или нескольких статей arXiv, используя официальные метаданные arXiv (название, авторы, год, основная категория), но никогда не поля, сгенерированные моделью. Суффиксы версий (например, '2401.12345v2') сохраняются, а ключи цитирования детерминированы. Возвращает сформированный BibTeX, а также статус/ошибку для каждой статьи. Только BibTeX; RIS/CSL-JSON пока не поддерживаются.

Получает аннотацию и метаданные по arXiv ID без скачивания статьи. Используйте перед download_paper для оценки релевантности. Возвращает название, авторов, аннотацию, категории, дату публикации и URL PDF. После компактного поиска используйте для получения одной полной аннотации; пропустите, если поиск использовал abstract_mode=full.

Скачивает, безопасно обрабатывает, кэширует и возвращает ограниченный исходный LaTeX-код. Используйте инструменты разделов для адресного чтения.

Возвращает одну ограниченную секцию LaTeX по идентификатору или заголовку структуры (нормализованы пробелы и регистр; раскрыты макросы).

Возвращает постраничную структуру заголовков для загруженного документа (markdown). Стабильные иерархические идентификаторы разделов; чтобы получить один раздел, используйте read_paper_section.

Возвращает компактный план заголовков из исходного LaTeX-кода.

Перечисляет все статьи, которые были загружены и сохранены локально через download_paper. Возвращает id, title, authors, published и arxiv_version/versioned_id из локальных метаданных — без повторного запроса в реальном времени. Установите compact=true, чтобы вернуть только идентификаторы arXiv. Возвращает пустой список, если ещё не было загружено ни одной статьи. Рабочий процесс: search_papers -> download_paper -> list_papers -> read_paper.

Выводит список всех сохранённых отслеживаний тем без проверки новых статей. Возвращает тему каждого отслеживания, категории, временную метку last_checked и другие сохранённые поля. Не обновляет last_checked: используйте эту команду для просмотра сохранённых данных. Для удаления отслеживания используйте unwatch_topic, а для опроса новых статей — check_alerts.

Читает текстовое содержимое статьи, которая была ранее загружена через download_paper. Возвращает статью в формате Markdown, по умолчанию ограниченном примерно 12 000 символов, чтобы один вызов не возвращал неограниченный текст статьи. Когда is_truncated равен true, вызовите снова с параметром start=next_start (см. next_retrieval), чтобы продолжить, или передайте return_full_text=true для получения всего оставшегося текста статьи. Завершится ошибкой с понятным сообщением, если статья еще не загружена — сначала вызовите download_paper. Рабочий процесс: search_papers -> download_paper -> read_paper.

Возвращает один ограниченный раздел Markdown по идентификатору структуры (или уникальному заголовку). Не включает соседние или родительские разделы.

Перестраивает локальный семантический индекс для загруженных статей.

Ищет в arXiv по запросу с опциональными категориями, диапазоном дат, сортировкой и пагинацией. Запрос: используй кавычки для фраз; ti:/au:/abs:/cat:; AND/OR/ANDNOT. Термины без префиксов ищутся в заголовке+аннотации (не в авторах). Используй категории (cs.AI, cs.LG, cs.CL, cs.CV, cs.MA, cs.RO, stat.ML, quant-ph). Каталог и примеры: README 'search_papers query guide'. Даты в формате YYYY-MM-DD (date_from/date_to). sort_by relevance|date. max_results по умолчанию 5 (максимум 50). abstract_mode none|snippet|full (по умолчанию snippet). start по умолчанию 0. Ответ: total_results, returned, has_more, next_start, abstract_mode. Передавай next_start с тем же abstract_mode. Используй get_abstract после компактного поиска — но не после abstract_mode=full. arXiv требует паузы ~3 секунды между запросами (на стороне сервера). Временные ошибки 429/503 повторяются с backoff; при превышении лимита возвращается status=rate_limited.

Ищет в скачанной статье совпадающие фрагменты заданной длины с указанием смещений в разделе/источнике. Подавляет почти дубликаты с высоким перекрытием и предпочитает результаты из разных разделов. Облегчённый поиск подстрок; без Torch.

Выполняет семантический поиск по статьям, которые вы уже загрузили локально через download_paper. Поддерживает запросы в свободной форме (например, 'механизмы внимания для длинных последовательностей') или поиск статей, похожих на заданный paper_id. ВАЖНО: поиск выполняется только по вашей локальной коллекции загруженных статей — вернет пустые результаты, если статьи еще не загружены. Используйте search_papers для поиска статей на arXiv, затем download_paper, чтобы добавить их в локальный индекс перед использованием этого инструмента. Требует pro-зависимости: uvx --from 'arxiv-mcp-server[pro]' arxiv-mcp-server (или uv tool install 'arxiv-mcp-server[pro]').

Удаляет сохранённую подписку на тему по точной строке темы. Тема должна точно совпадать с сохранённым значением watch_topic. Возвращает понятную ошибку «не найдено», если подходящая подписка отсутствует. Используйте list_watches для просмотра сохранённых подписок перед удалением.

Сохраняет или обновляет постоянное отслеживание темы исследования. При проверке через check_alerts возвращает только статьи, опубликованные с момента последней проверки, и служит постоянным оповещением о новых работах по теме. Новые отслеживания устанавливают last_checked на время создания, чтобы первая проверка не выдавала исторические совпадения. Строка темы использует тот же синтаксис запросов, что и search_papers (фразы в кавычках, указатели полей, логические операторы). Примеры: '"diffusion models" AND ti:"video generation"', 'au:"LeCun" AND cs.LG'. Вызов watch_topic с той же строкой темы обновляет существующее отслеживание, а не создает дубликат. При обновлении опускает categories для сохранения существующих фильтров; передача categories: [] очищает их. Сочетается с check_alerts для опроса новых статей.