blazickjp/arxiv-mcp-server

arxiv‑mcp‑server – arXiv 논문 읽기 및 정리를 위한 로컬 MCP 도구

개요 – Model Context Protocol (MCP)을 사용하는 작은 Python 기반 서버입니다. 로컬에서 실행되며(uvx 또는 일반 명령으로) AI 어시스턴트/에이전트가 arXiv를 검색하고, 논문을 다운로드하고, 섹션별로(렌더링된 Markdown 버전과 원본 LaTeX 모두) 읽고, BibTeX 인용을 유지하고, 새 논문이 나타날 때 알려주는 토픽 워치를 설정할 수 있는 "도구" 세트를 노출합니다. 이 서버는 모델을 호스팅하지 않습니다. 이미 언어 모델이 있는 클라이언트에 데이터를 제공할 뿐입니다.

주요 기능

기능	사용 방법	얻는 것
arXiv 검색 (search_papers)	쿼리, 선택적 카테고리, 날짜 범위, 정렬 제공	최대 5개의 간결한 결과(제목, 저자, 스니펫) – 페이지 매김 및 전체 초록 요청 가능
다운로드 및 읽기 (download_paper, read_paper)	arXiv ID 제공; 서버가 HTML → Markdown(PDF 폴백)을 가져와 로컬에 저장	논문의 제한된 청크(기본 12,000자)와 페이지 매김 정보. 전체 텍스트는 명시적으로 요청할 수 있음
섹션 수준 접근 (get_paper_outline, read_paper_section)	먼저 개요를 요청한 다음 특정 제목 ID를 요청	단일 섹션의 정확한 마크다운. 단계별 분석에 유용
원본 LaTeX (get_paper_latex, list_paper_latex_sections, get_paper_latex_section)	Markdown과 동일한 흐름이지만 저자가 제출한 LaTeX 소스를 가져옴	정확한 방정식이나 매크로가 필요할 때 유용한 제한된 LaTeX 스니펫
인용 처리 (citation_graph, export_citations)	논문의 참고 문헌 및 인용 작품(Semantic Scholar) 쿼리 또는 BibTeX 내보내기	작은 인용 그래프와 붙여넣기 가능한 BibTeX 항목
토픽 워치 (watch_topic, check_alerts, …)	키워드 + 선택적 arXiv 카테고리 저장; 서버가 마지막 확인 타임스탬프 기록	check_alerts 호출 시 워치와 일치하는 새 논문 수신
시맨틱 검색 (semantic_search, reindex) – pro 엑스트라	논문 다운로드 후 로컬 임베딩 인덱스 실행하여 의미로 검색	arXiv에 연락하지 않고 유사 논문 찾기; 선택적 pro 엑스트라 필요

실행 방법

• 가장 빠름 – uvx arxiv-mcp-server. uvx는 격리된 환경을 만들고 PyPI에서 패키지를 다운로드하며(arxiv-mcp-server==0.8.2), stdio에서 서버를 시작합니다.
• PATH에 영구적으로 – uv tool install arxiv-mcp-server (또는 [pdf] / [pro] 엑스트라 추가).
• HTTP 모드 – TRANSPORT=http 및 HOST/PORT 환경 변수 설정; 클라이언트는 http://host:port/mcp에 연결합니다.

클라이언트 통합 README에는 다양한 MCP 인식 도구(Claude Code, OpenAI Codex, Hermes Agent, VS Code/Kiro, Claude Desktop)용 기성 JSON 스니펫이 포함되어 있습니다. 스니펫은 클라이언트가 uvx(또는 설치된 바이너리)로 서버를 시작하고 선택적으로 사용자 지정 저장 디렉토리(기본값 ~/.arxiv-mcp-server/papers)를 가리키도록 지시합니다.

단순 검색 래퍼가 아닌 이유 서버는 검색이나 인용 그래프 구축의 무거운 작업을 수행하지 않습니다. 이러한 호출은 공식 arXiv API, Semantic Scholar 등으로 전송됩니다. 사용자 머신에 남는 것은 문헌 루프입니다 – 논문 다운로드, 로컬 Markdown/LaTeX 사본 유지, 개요 추출, 워치 관리. 이를 통해 LLM이 실제로 볼 데이터를 제어하고 큰 PDF를 모델 컨텍스트에 반복적으로 가져오는 것을 피할 수 있습니다.

누가 혜택을 받는가

• LLM 어시스턴트를 사용하여 새 주제를 탐색하고 어시스턴트가 주문형으로 실제 논문을 가져오길 원하는 연구자나 학생.
• 자체 arXiv 스크레이퍼를 구축하지 않고 신뢰할 수 있는 로컬 학술 콘텐츠 소스가 필요한 사용자 지정 AI 에이전트를 개발하는 개발자.
• 재현 가능한 인용 데이터(BibTeX)와 소스에서 직접 LaTeX 섹션을 읽을 수 있는 기능을 원하는 모든 사람.

설치 함정

• 패키지는 PyPI에만 게시됩니다. 같은 이름의 무관한 npm 패키지가 존재합니다 – npm으로 설치하지 마십시오.
• macOS/Windows GUI 앱에서는 PATH가 터미널과 다를 수 있습니다. `를 교체해야 할 수 있습니다.