paper-search-mcp MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Unified search_papers across 20+ sources
Platform-specific search + download tools per source
download_with_fallback picks the best source for a DOI
Free-first: public sources by default, paid optional
Python + uvx install

Живое демо

Как выглядит на практике

paper-search.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "paper-search": {
      "command": "uvx",
      "args": [
        "paper-search-mcp"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "paper-search": {
      "command": "uvx",
      "args": [
        "paper-search-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "paper-search": {
      "command": "uvx",
      "args": [
        "paper-search-mcp"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "paper-search": {
      "command": "uvx",
      "args": [
        "paper-search-mcp"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "paper-search",
      "command": "uvx",
      "args": [
        "paper-search-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "paper-search": {
      "command": {
        "path": "uvx",
        "args": [
          "paper-search-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add paper-search -- uvx paper-search-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: paper-search-mcp

How to build a literature review bibliography from a prompt

👤 Researchers, grad students ⏱ ~30 min intermediate

Когда использовать: New topic, need a starting set of 20-50 papers.

Предварительные требования

uv — brew install uv

Поток

Broad search

search_papers 'mechanistic interpretability attention heads' across arXiv, Semantic Scholar, OpenAlex. Return top 30 by citations.✓ Скопировано

→ Cross-source list with titles, authors, citation counts
Download the winners

For the top 10 by citation, download_with_fallback to /papers/interp/.✓ Скопировано

→ PDFs saved
Extract abstracts

Read each PDF's abstract and produce a grouped summary.✓ Скопировано

→ Grouped bibliography

Итог: Starter bibliography you can actually read.

Подводные камни

Duplicate entries across sources — Deduplicate by DOI before ranking
Closed-access papers without OA versions — Use download_with_fallback which tries OA mirrors (arXiv, Unpaywall) first

Сочетать с: filesystem

How to find the latest papers on a topic since a date

👤 Researchers tracking a fast-moving area ⏱ ~20 min beginner

Когда использовать: Weekly/monthly scan.

Поток

Date-bounded search

search_arxiv 'constitutional AI' submitted after 2026-01-01. Sort by date desc.✓ Скопировано

→ Recent list
Read new abstracts

For each new paper, get the abstract and tag: confirms prior work / extends / contradicts / unrelated.✓ Скопировано

→ Tagged triage

Итог: Up-to-date view without wading through the whole feed.

Сочетать с: notion

How to cross-check a clinical claim in PubMed + Europe PMC

👤 Clinicians, biotech researchers ⏱ ~25 min intermediate

Когда использовать: A patient-facing doc makes a claim and you want to verify.

Поток

Search PubMed

search_pubmed 'metformin cognitive decline' — RCTs only, 2020+.✓ Скопировано

→ RCT list
Pull full context from Europe PMC if needed

For the top 5, check if Europe PMC has the full text (OA).✓ Скопировано

→ Full texts where available

Итог: Source-backed verification.

Подводные камни

Do not rely on abstracts alone for clinical decisions — Read the actual methodology before citing

Комбинации

Сочетайте с другими MCP — эффект x10

paper-search + markdownify

Convert downloaded PDFs to markdown for RAG ingestion

For every PDF in /papers/interp/, run pdf-to-markdown and save to /kb/papers/.✓ Скопировано

paper-search + deep-research

Cross-check a deep research report's sources against arXiv

Given this deep research report, identify any 2024-2026 arXiv papers missing from the citations.✓ Скопировано

paper-search + notion

Maintain a research reading log

Add each newly-downloaded paper to the Notion 'Reading Log' database with title, authors, DOI, and a 3-line summary.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search_papers	query, sources?: str[], limit?: int, year_min?: int	Multi-source search	free (public APIs)
download_with_fallback	doi_or_arxiv_id, dest_dir	Get PDF via best available route	free
search_arxiv	query, sort?, year_min?	arXiv-specific	free
download_arxiv	arxiv_id, dest_dir	Get arXiv PDF	free
search_pubmed	query, filters?	Biomedical search	free
search_semantic_scholar	query	Citation-aware search	free
search_biorxiv	query	Biology preprints	free

Стоимость и лимиты

Во что обходится

Квота API: Public APIs have per-IP rate limits (arXiv 3 req/s, PubMed 3/s without key)
Токенов на вызов: Search metadata: 200-1000 tokens per paper; PDFs are file-based (no token cost)
Деньги: Free for public sources; paid sources (IEEE, ACM) need their own keys
Совет: Get a free NCBI API key for 10x PubMed rate; arXiv has no key but respect the 3 req/s limit.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Filesystem write to your download directory Optional keys for paid sources

Хранение учётных данных: Env vars for optional API keys

Исходящий трафик: Hits the public academic APIs you enable

Никогда не давайте: Nothing destructive — all read/download

Respect per-source terms of use — bulk downloading can get your IP blocked.

Устранение неполадок

Частые ошибки и исправления

429 rate limit

Throttle — arXiv needs 3 req/s max, PubMed without key is 3/s. Back off.

download_with_fallback fails for a closed-access DOI

No legal free source exists. Use your library's subscription; this tool only uses OA routes.

Search returns fewer results than the source's website

Some APIs have narrower indexes than their UIs. Cross-check with search_semantic_scholar which has broad coverage.

PDF downloaded but unreadable

Source may return an HTML splash page instead of PDF; check file type and report via the issue tracker.

Проверить: file path/to/downloaded.pdf

Альтернативы

paper-search-mcp в сравнении

Альтернатива	Когда использовать	Компромисс
arxiv-mcp	You only need arXiv, nothing else	Single-source only
deep-research MCP	You want synthesis, not just retrieval	LLM costs; different shape

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills