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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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는 맵이 아닌 서버 오브젝트 배열 사용.

~/.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와 조합해 10배 효율

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

paper-search-mcp