Paper Search MCP
MCP-сервер для поиска и загрузки научных статей из arXiv, PubMed, bioRxiv, Semantic Scholar и других открытых источников
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Ходит во внешние научные сервисы и скачивает файлы на диск
- Опциональные ключи API передаются на сторонние серверы
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/paper-search-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>' paper-search-mcp -- uvx paper-search-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"paper-search-mcp","type":"stdio","command":"uvx","args":["paper-search-mcp"],"env":{"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL":"<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"paper-search-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add paper-search-mcp --env 'PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>' -- uvx paper-search-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.paper-search-mcp]
command = "uvx"
args = ["paper-search-mcp"]
env = { PAPER_SEARCH_MCP_UNPAYWALL_EMAIL = "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'PAPER_SEARCH_MCP_UNPAYWALL_EMAIL=<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>' paper-search-mcp uvx paper-search-mcpИли добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"paper-search-mcp": {
"type": "local",
"command": [
"uvx",
"paper-search-mcp"
],
"environment": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": [
"paper-search-mcp"
],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "<значение PAPER_SEARCH_MCP_UNPAYWALL_EMAIL>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
PAPER_SEARCH_MCP_UNPAYWALL_EMAILобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи через uvx или добавь в конфигурацию MCP команду uvx с пакетом paper-search-mcp. Для источника Unpaywall задай переменную PAPER_SEARCH_MCP_UNPAYWALL_EMAIL с любым валидным email.
Другие способы из описания автора
{
"mcpServers": {
"paper-search-mcp": {
"command": "uvx",
"args": ["paper-search-mcp"],
"env": {
"PAPER_SEARCH_MCP_UNPAYWALL_EMAIL": "your@email.com"
}
}
}
}Запуск через uvx без постоянной установки. Email нужен только для источника Unpaywall.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту единый поиск и загрузку научных статей из множества источников. Верхний уровень объединяет параллельный поиск по нескольким базам с дедупликацией и цепочку загрузки, которая идет от источника к открытому доступу и резолвингу по DOI. Нижний уровень это модульные коннекторы к arXiv, PubMed, bioRxiv, medRxiv, Semantic Scholar, Crossref, OpenAlex, PubMed Central, Europe PMC, CORE, Zenodo, HAL и другим. Результаты приводятся к единому виду, для части статей доступны выгрузка PDF и извлечение текста. Проект следует принципу свободных источников: открытые базы в приоритете, ключи API опциональны и лишь расширяют лимиты и охват. Кроме MCP-сервера, доступны скилл для Claude Code и CLI поверх той же библиотеки.
Для кого. Для исследователей, аналитиков и технических писателей, которые собирают научную литературу через агента.
Подходит, если
- Нужно найти статьи по теме сразу в нескольких научных базах
- Нужно скачать PDF или извлечь текст статьи по идентификатору или DOI
- Нужно собрать список источников с приоритетом открытого доступа
Не подходит, если
- Нужен полный текст из платных баз без доступа к ним
- Достаточно обычного веб-поиска без установки сервера
Пример запроса к агенту
Найди свежие статьи про базовое редактирование CRISPR в arXiv и Semantic ScholarОграничения
Все ключи API опциональны, кроме Unpaywall, который требует email в переменной окружения, иначе источник отключается. Часть источников ограничена на стороне провайдера: Google Scholar и SSRN блокируют ботов, Semantic Scholar и CORE могут упираться в лимиты без ключа. Коннекторы IEEE и ACM пока заготовки и включаются только при своем ключе. Загрузка PDF доступна в основном для открытого доступа. Опциональный коннектор Sci-Hub нестабилен и ответственность за его использование лежит на пользователе.
Как отключить. Удалите сервер из конфигурации MCP клиента. Если ставили пакет, удалите его через pip или uv, скилл для Claude Code удалите из каталога скиллов.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| PAPER_SEARCH_MCP_UNPAYWALL_EMAIL обязательная | Любой валидный email, без него источник Unpaywall отключается. |
| PAPER_SEARCH_MCP_CORE_API_KEY секрет | Бесплатный ключ CORE, повышает стабильность загрузки из репозиториев. |
| PAPER_SEARCH_MCP_SEMANTIC_SCHOLAR_API_KEY секрет | Бесплатный ключ Semantic Scholar, повышает лимиты запросов. |
| PAPER_SEARCH_MCP_GOOGLE_SCHOLAR_PROXY_URL | URL прокси для обхода блокировки ботов в Google Scholar. |
| PAPER_SEARCH_MCP_IEEE_API_KEY секрет | Активирует коннектор IEEE Xplore, который иначе остается заготовкой. |
| PAPER_SEARCH_MCP_ACM_API_KEY секрет | Активирует коннектор ACM Digital Library, который иначе остается заготовкой. |
Проверка безопасности
- Ходит во внешние научные сервисы и скачивает файлы на диск
- Опциональные ключи API передаются на сторонние серверы
Коротко о README
README описывает MCP-сервер на Python для поиска и загрузки научных статей из более чем двадцати источников с приоритетом открытого доступа. Архитектура двухслойная: единый поиск с дедупликацией и цепочкой загрузки сверху и модульные коннекторы к конкретным базам снизу. Приведена таблица возможностей по каждому источнику и список опциональных переменных окружения с ключами. Установка возможна через Smithery, uvx, uv, pip, npx, Docker или из исходников, а для Claude Code есть вариант в виде скилла. Лицензия MIT.
Частые вопросы
Обязательны ли ключи API?
Нет, кроме email для Unpaywall. Открытые базы работают без ключей, а ключи для Semantic Scholar, CORE и других лишь повышают лимиты и стабильность.
Можно ли ставить как скилл, а не сервер?
Да. Для Claude Code есть отдельный скилл поверх CLI paper-search, он подключается без настройки MCP.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики