arxiv-mcp-server

arxiv-mcp-server

에이전트 문헌 작업을 위한 로컬 MCP 서버입니다. 차별점은 원본 LaTeX 섹션 읽기, arXiv 메타데이터에서 추출한 BibTeX, 그리고 주제 워치입니다. 논문은 디스크에 남습니다. 작업 루프는 논문 ID → 개요 → 한 섹션 → 인용입니다. 검색은 선택 사항입니다.

설치
기본 설치는 uvx arxiv-mcp-server 입니다. 명령 기반 통합에는 uvx 를 제공하는 uv 가 필요합니다. 저장소 클론이나 Python 환경 설정은 필요하지 않습니다.

uvx arxiv-mcp-server
mcpServers JSON 형식을 지원하는 클라이언트(예: Claude Desktop, Kiro)에 이 stdio 구성을 추가하세요. 다른 클라이언트는 최상위 servers 객체, TOML, 또는 자체 설정 UI를 사용할 수 있습니다. 해당 클라이언트의 MCP 문서를 참고하세요.

{
"mcpServers" : {
"arxiv" : {
"type" : " stdio " ,
"command" : " uvx " ,
"args" : [ " arxiv-mcp-server " ]
}
}
}
기본 논문 디렉터리는 ~/.arxiv-mcp-server/papers 입니다. 다른 디렉터리를 선택하려면 args 에 "--storage-path", "/absolute/path/to/papers" 를 추가하세요.

지원되는 패키지는 PyPI에 arxiv-mcp-server==0.8.2 로 게시되어 있습니다. 관련 없는 npm 패키지가 같은 이름을 사용하므로, 이 서버를 npm, pnpm, 또는 npx arxiv-mcp-server 로 설치하지 마세요.

공식 MCP 레지스트리 에 등록되어 있으며, 최신 버전은 0.8.2입니다.

검색 래퍼가 아닌 이유
검색, 소스 검색, 인용 그래프, 다운로드는 각각의 외부 서비스를 호출합니다. 로컬에 남는 것은 문헌 루프입니다. 저자가 제출한 LaTeX를 한 번에 한 섹션씩 읽고, 권위 있는 arXiv 메타데이터에서 BibTeX를 내보내며, 주제 워치를 디스크에 유지합니다. 서버는 기본적으로 stdio를 통해 로컬에서 실행됩니다.

클라이언트별 레시피 (Claude Code, Codex, Hermes, VS Code / Kiro, Claude Desktop, 플러그인)
클라이언트에 한 줄 도우미가 없다면 위의 기본 JSON을 사용하세요.

Claude Code
모든 프로젝트에 MCP 서버를 추가합니다:

claude mcp add --transport stdio --scope user arxiv -- uvx arxiv-mcp-server
더 풍부한 플러그인 통합( MCP 연결과 번들 arXiv 리서치 스킬을 함께 설치)을 원하면 이 저장소를 마켓플레이스로 등록하고 플러그인을 설치하세요:

claude plugin marketplace add blazickjp/arxiv-mcp-server
claude plugin install arxiv-mcp-server@arxiv-mcp
직접 MCP 설치를 확인하려면 claude mcp get arxiv 를 실행하세요. 플러그인 설치 후에는 Claude Code를 재시작하거나 /reload-plugins 를 실행하세요.

OpenAI Codex
MCP 서버를 추가합니다:

codex mcp add arxiv -- uvx arxiv-mcp-server
또는 MCP 연결과 번들 리서치 스킬을 Codex 플러그인으로 설치하세요:

codex plugin marketplace add blazickjp/arxiv-mcp-server
codex plugin add arxiv-mcp-server@arxiv-mcp
직접 MCP 설치를 확인하려면 codex mcp get arxiv 를 실행하세요. Codex CLI, Codex IDE 확장, ChatGPT 데스크톱 앱의 Codex는 이 MCP 구성을 공유합니다.

Hermes Agent

서버를 추가하고, 발견된 도구를 승인하고, 저장된 연결을 테스트하세요:

hermes mcp add arxiv --command uvx --args arxiv-mcp-server
hermes mcp test arxiv
VS Code 및 Kiro

더 풍부한 Kiro Power 통합을 원하면 Powers 패널을 열고 Add Custom Power → Import power from GitHub 를 선택한 뒤 다음을 입력하세요:

https://github.com/blazickjp/arxiv-mcp-server

Power는 mcp.json 에서 MCP 연결을 설치하고 집중된 arXiv 리서치 가이드를 추가합니다. 수동 구성을 선호하는 Kiro 사용자는 위의 일반 구성을 워크스페이스 하나에 적용하려면 .kiro/settings/mcp.json 에, 모든 워크스페이스에 적용하려면 ~/.kiro/settings/mcp.json 에 배치할 수 있습니다.

Claude Desktop 번들
macOS 사용자는 v0.8.2 릴리스 또는 최신 GitHub 릴리스 에서 번들 .mcpb 확장을 설치할 수 있습니다:

Apple Silicon: arxiv-mcp-server-darwin-arm64-0.8.2.mcpb
Intel: arxiv-mcp-server-darwin-x86_64-0.8.2.mcpb

번들을 더블클릭하거나, Claude Desktop으로 드래그하거나, Settings → Extensions → Advanced settings → Install Extension… 을 여세요. 번들에는 서버 의존성이 포함되어 있으며 CPython 3.11.x가 필요합니다.

기타 MCP 클라이언트
다른 클라이언트는 최상위 servers 객체, TOML, 또는 자체 설정 UI를 사용할 수 있습니다. 해당 클라이언트의 MCP 문서를 참고하세요. 직접 MCP 설치가 가장 짧은 경로입니다. 클라이언트를 집중 검색, 제한된 읽기, 인용 탐색, 섹션 수준 LaTeX 검색으로 이끄는 리서치 워크플로도 원한다면 플러그인을 설치하세요.

플러그인 매니페스트
동일한 MCP 서버와 리서치 스킬이 두 주요 플러그인 시스템용으로 패키징되어 있습니다:

통합
매니페스트
마켓플레이스

Claude Code
.claude-plugin/plugin.json
.claude-plugin/marketplace.json

OpenAI Codex / ChatGPT Work
.codex-plugin/plugin.json
.agents/plugins/marketplace.json

Kiro Power
POWER.md
mcp.json

공유 MCP 실행
Claude 및 저장소 로컬 클라이언트용 .mcp.json ; Codex 플러그인용 .codex-mcp.json
uvx arxiv-mcp-server

공유 리서치 워크플로
skills/arxiv-mcp-server/SKILL.md
두 플러그인 중 하나와 함께 설치됨

데스크톱 클라이언트가 uvx를 찾지 못하는 경우
데스크톱 애플리케이션은 터미널과 동일한 PATH를 상속하지 않는 경우가 있습니다. 터미널에서는 uvx arxiv-mcp-server 가 작동하지만 클라이언트가 서버 연결 실패를 보고하면, 실행 파일의 절대 경로를 찾으세요:

# macOS and Linux
command -v uvx
# Windows PowerShell
( Get-Command uvx).Source
"command": "uvx" 를 반환된 절대 경로로 바꾼 뒤 클라이언트를 재시작하세요. args 값은 그대로 유지하세요.

기존 설치에 최신 도구가 없는 경우
uvx 는 캐시된 도구 환경을 재사용합니다. 지원되는 인터프리터로 현재 PyPI 릴리스를 확인하도록 강제한 뒤 MCP 클라이언트를 재시작하세요:

uvx --python 3.11 --refresh-package arxiv-mcp-server arxiv-mcp-server
클라이언트가 여전히 이전 환경을 실행한다면, args 배열에서 "arxiv-mcp-server" 앞에 "--python", "3.11" 을 추가하세요.

영구 명령 설치
uvx 를 통해 실행하는 대신 arxiv-mcp-server 를 PATH에 배치하려면:

uv tool install arxiv-mcp-server
명령이 즉시 사용 가능하지 않으면 uv tool update-shell 을 실행하고 터미널을 재시작하세요. 이후에는 "command": "arxiv-mcp-server" 를 사용하고 args 에서 패키지 이름을 생략하세요.

도구
서버는 현재 19개의 도구를 제공합니다.

도구
목적
비고

search_papers
쿼리, 카테고리, 날짜, 정렬 순서로 arXiv 검색
기본 ≤5개의 간결한 결과( abstract_mode=snippet ); 원격 arXiv API

get_abstract
arXiv ID로 메타데이터와 초록 가져오기
논문을 다운로드하지 않음

download_paper
논문을 다운로드하여 로컬 Markdown으로 변환
HTML 우선; PDF 폴백은 [pdf] 사용; force=true 로 재가져오기; 콘텐츠는 기본적으로 12,000자로 제한

list_papers
로컬에 저장된 논문 목록
id, title, authors, published 반환; ID만 원하면 compact

read_paper
로컬에 저장된 논문 콘텐츠 읽기
기본적으로 12,000자로 제한; start / max_chars / return_full_text 지원

get_paper_outline
페이지네이션된 markdown 제목 개요
안정적인 계층적 섹션 ID

read_paper_section
하나의 제한된 markdown 섹션 읽기
개요 ID 또는 고유 제목으로

search_paper_text
논문 내 제한된 구절 검색
소스 오프셋; Torch 불필요

get_paper_latex
제한된 저자 제출 LaTeX 검색
원격 arXiv 소스 아카이브

list_paper_latex_sections
페이지네이션된 LaTeX 개요 반환
start 및 max_sections 지원

get_paper_latex_section
하나의 제한된 LaTeX 섹션 읽기
개요 ID 또는 정확한 제목으로 선택

citation_graph
참고문헌 및 인용 논문 가져오기
원격 Semantic Scholar API(논문당 1회 호출, 디스크에 캐시); 선택적 무료 API 키로 신뢰성 향상

export_citations
하나 이상의 arXiv ID에 대한 BibTeX 내보내기
권위 있는 arXiv 메타데이터

watch_topic
arXiv 주제 워치 저장 또는 업데이트
로컬에 저장; 업데이트 시 categories 생략하면 유지, categories: [] 는 초기화

list_watches
저장된 주제 워치 목록
읽기 전용; last_checked 를 진행시키지 않음

check_alerts
저장된 워치에서 새 논문 확인
마지막 확인 이후의 논문 반환

unwatch_topic
저장된 주제 워치 삭제
정확한 주제 일치; 없으면 not-found

semantic_search
다운로드한 논문을 의미적 유사도로 검색
[pro] 필요

reindex
로컬 의미 인덱스 재구축
[pro] 필요

리서치 알림 ( watch_topic )
watch_topic 으로 상시 주제 워치를 저장하고, list_watches 로 검사하고, check_alerts 로 폴링하고, unwatch_topic 으로 제거하세요.

기존 워치를 업데이트할 때(동일한 주제 문자열):

categories 생략 → 저장된 카테고리 필터(및 변경하지 않은 다른 필드) 유지.
categories: [] 전달 → 카테고리 필터 초기화.
비어 있지 않은 목록 전달 → 저장된 필터 교체.

생성 경로: categories 생략 시 빈 목록 저장(카테고리 필터 없음).

search_papers 쿼리 가이드
도구 스키마는 의도적으로 짧게 유지됩니다. 쿼리 튜토리얼, 카테고리 카탈로그, 워크플로 예시에는 이 섹션(항상 로드되는 MCP 설명이 아님)을 사용하세요.

쿼리 구성

정확한 일치에는 따옴표 구문 사용: "multi-agent systems" , "neural networks"
관련 개념은 OR로 결합: "AI agents" OR "software agents"
필드별 검색: ti:"exact title phrase" , au:"author name" , abs:"keyword" , cat:cs.LG
ANDNOT으로 제외: "machine learning" ANDNOT "survey"
긴 키워드 목록보다 2–4개의 핵심 개념 선호

고급 패턴

필드 + 구문: ti:"transformer architecture"
여러 필드: au:"Smith" AND ti:"quantum"
제외: "deep learning" ANDNOT ("survey" OR "review")
광범위 + 좁은 범위: "artificial intelligence" AND (robotics OR "computer vision")

카테고리 필터링 (관련성에 권장)

Computer Science: cs.AI (AI), cs.LG (ML), cs.CL (NLP), cs.CV (vision), cs.MA (multi-agent), cs.RO (robotics), cs.NE (neural/evolutionary), cs.IR (IR), cs.HC (HCI), cs.CR (security), cs.DB (databases)

Statistics & Math: stat.ML , stat.AP , math.OC , math.ST

Physics & other: quant-ph , eess.SP , eess.AS , physics.data-an

효과적인 예시

ti:"reinforcement learning" with categories: ["cs.LG", "cs.AI"]
au:"Hinton" AND "deep learning" with categories: ["cs.LG"]
"multi-agent" ANDNOT "survey" with categories: ["cs.MA"]
abs:"transformer" AND ti:"attention" with categories: ["cs.CL"]

날짜 및 정렬

날짜는 YYYY-MM-DD 형식( date_from / date_to )
기본 sort_by 는 relevance ; 최신순 모니터링에는 date 사용
기초 연구: date_to: "2010-12-31" 과 제목/초록 필드 검색

결과 크기, 초록, 페이지네이션

기본 max_results 는 5(상한 50). 더 큰 페이지에는 명시적 값을 전달하세요.
abstract_mode : snippet (기본, ~280자, 잘리면 … [truncated] 표시), full (전체 초록), 또는 none (초록 생략). 기타 메타데이터(제목, 저자, 카테고리, 날짜, URL)는 항상 반환됩니다.
응답은 total_results (코퍼스 적중 수), returned , has_more , start , next_start , abstract_mode 를 보고합니다
다음 페이지에는 동일한 abstract_mode 로 start=next_start 를 전달하세요
arXiv는 요청 간 ~3초를 강제합니다(서버 측에서 처리); 속도 제한 오류 시 ~60초 대기하세요

논문 검색 및 검사
MCP 클라이언트에 다음으로 search_papers 를 호출하도록 요청하세요:

{
"query" : " \" Kolmogorov-Arnold Networks \" " ,
"categories" : [ " cs.LG " , " cs.AI " ],
"sort_by" : " date "
}
기본값은 초록 스니펫과 함께 최대 5개의 간결한 결과를 반환합니다. 검색 응답에 전체 초록이 필요하면 "abstract_mode": "full" 을 사용하거나, 간결한 검색 후 단일 논문에 대해 get_abstract 를 호출하세요:

{
"paper_id" : " 2404.19756 "
}
abstract_mode=full 로 이미 반환된 논문에 대해서는 get_abstract 를 다시 호출하지 마세요.

전체 텍스트 다운로드 및 읽기
다음으로 download_paper 를 호출하세요:

{
"paper_id" : " 2404.19756 "
}
max_chars 를 생략하면 제한된 첫 청크(기본 12,000 논문 문자)를 반환합니다. 캐시된 논문은 즉시 반환됩니다. 재다운로드하여 로컬 markdown과 사이드카를 덮어쓰려면 "force": true 를 전달하세요(HTML 추출기 버전이 변경될 때도 자동으로 발생).

그런 다음 read_paper 로 캐시된 콘텐츠를 페이지 단위로 읽으세요:

{
"paper_id" : " 2404.19756 " ,
"start" : 0
}
또는 이전 청크에서 이어서:

{
"paper_id" : " 2404.19756 " ,
"start" : 12000
}
대용량 콘텐츠 응답에는 content_length , returned_chars , next_start , is_truncated , 그리고 (잘린 경우) 다음 호출 지침이 담긴 next_retrieval 이 포함됩니다. 계속 읽으려면 next_start 를 다음 호출의 start 로 전달하세요. 기본 청크 크기를 재정의하려면 명시적 max_chars 를 전달하거나, 이전의 무제한 …을 선택하려면 "return_full_text": true 를 전달하세요