medRxiv MCP 서버

🔍 AI 보조원이 간단한 MCP 인터페이스를 통해 medRxiv 논문을 검색하고 접근할 수 있도록 합니다.

medRxiv MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 통해 AI 어시스턴트와 medRxiv의 프리프린트 저장소를 연결합니다. AI 모델이 프로그래밍 방식으로 의학 프리프린트 자료를 검색하고 콘텐츠에 접근할 수 있도록 지원합니다.

🤝 기여 • 📝 버그 신고

✨ 핵심 기능

• 🔎 논문 검색: 사용자 정의 검색 문자열이나 고급 검색 매개변수를 사용하여 medRxiv 논문을 쿼리하세요 ✅

• 🚀 효율적인 검색: 종이 메타데이터에 대한 빠른 액세스 ✅

• 📊 메타데이터 액세스: DOI를 사용하여 특정 논문의 자세한 메타데이터를 검색합니다.

• 📊 연구 지원: 건강 과학 연구 및 분석을 용이하게 합니다 ✅

• 📄 논문 접근: 논문 내용을 다운로드하고 읽어보세요 📝

• 📋 논문 목록: 다운로드한 모든 논문 보기 📝

• 🗃️ 로컬 스토리지: 더 빠른 접근을 위해 문서가 로컬에 저장됩니다. 📝

• 📝 연구 주제: 논문 분석을 위한 전문화된 주제 모음 📝

Related MCP server: paper-fetch-mcp

🚀 빠른 시작

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 medRxiv Server를 자동으로 설치하려면:

클로드

지엑스피1

커서

설정 → 커서 설정 → MCP → 새 서버 추가에 다음을 붙여넣습니다.

• 맥/리눅스

npx -y @smithery/cli@latest run @JackKuo666/medrxiv-mcp-server --client cursor --config "{}" 

윈드서핑

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client windsurf --config "{}"

C라인

npx -y @smithery/cli@latest install @JackKuo666/medrxiv-mcp-server --client cline --config "{}"

수동 설치

uv를 사용하여 설치:

uv tool install medRxiv-mcp-server

개발을 위해:

# Clone and set up development environment
git clone https://github.com/JackKuo666/medRxiv-MCP-Server.git
cd medRxiv-MCP-Server

# Create and activate virtual environment
uv venv
source .venv/bin/activate
uv pip install -r requirements.txt

📊 사용법

MCP 서버를 시작합니다.

python medrxiv_server.py

서버가 실행되면 제공된 MCP 도구를 AI 어시스턴트 또는 애플리케이션에서 사용할 수 있습니다. 다음은 도구 사용 방법의 몇 가지 예입니다.

예시 1: 키워드를 사용하여 논문 검색

result = await mcp.use_tool("search_medrxiv_key_words", {
    "key_words": "COVID-19 vaccine efficacy",
    "num_results": 5
})
print(result)

예 2: 고급 검색 수행

result = await mcp.use_tool("search_medrxiv_advanced", {
    "term": "COVID-19",
    "author1": "MacLachlan",
    "start_date": "2020-01-01",
    "end_date": "2023-12-31",
    "num_results": 3
})
print(result)

예제 3: 특정 논문의 메타데이터 가져오기

result = await mcp.use_tool("get_medrxiv_metadata", {
    "doi": "10.1101/2025.03.09.25323517"
})
print(result)

이 예제는 medRxiv MCP 서버에서 제공하는 세 가지 주요 도구를 사용하는 방법을 보여줍니다. 특정 사용 사례에 맞게 매개변수를 조정하세요.

🛠 MCP 도구

medRxiv MCP 서버는 다음과 같은 도구를 제공합니다.

검색_medrxiv_키워드

키워드를 사용하여 medRxiv에서 기사를 검색하세요.

매개변수:

• key_words (str): 검색 쿼리 문자열

• num_results (int, 선택 사항): 반환할 결과 수(기본값: 10)

반환: 기사 정보가 포함된 사전 목록

검색_medrxiv_고급

medRxiv에서 기사에 대한 고급 검색을 수행합니다.

매개변수:

• term (str, 선택 사항): 일반 검색어

• title (str, 선택 사항): 제목에서 검색

• author1 (str, 선택 사항): 첫 번째 작성자

• author2 (str, 선택 사항): 두 번째 작성자

• abstract_title (str, 선택 사항): 초록과 제목으로 검색

• text_abstract_title (str, 선택 사항): 전체 텍스트, 초록 및 제목에서 검색

• section (str, 선택 사항): medRxiv 섹션

• start_date (str, 선택 사항): 검색 범위의 시작 날짜(형식: YYYY-MM-DD)

• end_date (str, 선택 사항): 검색 범위의 종료 날짜(형식: YYYY-MM-DD)

• num_results (int, 선택 사항): 반환할 결과 수(기본값: 10)

반환: 기사 정보가 포함된 사전 목록

get_medrxiv_메타데이터

DOI를 사용하여 medRxiv 기사의 메타데이터를 가져옵니다.

매개변수:

• doi (str): 기사의 DOI

반환: 문서 메타데이터가 포함된 사전

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음 구성을 추가하세요.

(맥 OS)

{
  "mcpServers": {
    "medrxiv": {
      "command": "python",
      "args": ["-m", "medrxiv-mcp-server"]
      }
  }
}

(Windows 버전):

{
  "mcpServers": {
    "medrxiv": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "medrxiv-mcp-server"
      ]
    }
  }
}

Cline과 함께 사용

{
  "mcpServers": {
    "medrxiv": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/mcp-server-medRxiv/.venv/bin/activate && python /home/YOUR/PATH/mcp-server-medRxiv/medrxiv_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop을 다시 시작하면 다음 기능을 사용할 수 있습니다.

논문 검색

다음과 같은 쿼리를 사용하여 Claude에게 논문 검색을 요청할 수 있습니다.

Can you search medRxiv for recent papers about genomics?

검색을 통해 다음을 포함한 일치하는 논문에 대한 기본 정보가 반환됩니다.

• 논문 제목

• 저자

• 도이

논문 세부 정보 얻기

DOI를 받으면 더 자세한 내용을 요청할 수 있습니다.

Can you show me the details for paper 10.1101/003541?

그러면 다음이 반환됩니다.

• 전체 논문 제목

• 저자

• 출판일

• 논문 초록

• 사용 가능한 형식(PDF/HTML)에 대한 링크

📝 할 일

다운로드_논문

논문을 다운로드하여 로컬에 저장하세요.

읽다_논문

다운로드한 논문의 내용을 읽어보세요.

논문 목록

다운로드한 모든 논문을 나열합니다.

📝 연구 주제

이 서버는 학술 논문을 분석하는 데 도움이 되는 전문적인 프롬프트를 제공합니다.

논문 분석 프롬프트

논문 ID만 있으면 학술 논문을 분석할 수 있는 포괄적인 워크플로:

result = await call_prompt("deep-paper-analysis", {
    "paper_id": "2401.12345"
})

이 프롬프트에는 다음이 포함됩니다.

• 사용 가능한 도구(list_papers, download_paper, read_paper, search_papers) 사용에 대한 자세한 지침

• 논문 분석을 위한 체계적인 워크플로

• 다음을 포함하는 포괄적인 분석 구조:

  • 요약

  • 연구 맥락

  • 방법론 분석

  • 결과 평가

  • 실용적 및 이론적 의미

  • 향후 연구 방향

  • 더 광범위한 영향

📁 프로젝트 구조

• medrxiv_server.py : FastMCP를 사용한 주요 MCP 서버 구현

• medrxiv_web_search.py : medRxiv 검색을 위한 웹 스크래핑 로직을 포함합니다.

🔧 종속성

• 파이썬 3.10+

• 패스트MCP

• 비동기

• 벌채 반출

• 요청(웹 스크래핑용, medrxiv_web_search.py에서 사용)

• beautifulsoup4(웹 스크래핑용, medrxiv_web_search.py에서 사용)

다음을 사용하여 필요한 종속성을 설치할 수 있습니다.

pip install FastMCP requests beautifulsoup4

🤝 기여하기

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

🙏 감사의 말

이 프로젝트는 arxiv-mcp-server 프로젝트에서 수행된 작업에서 영감을 얻어 구축되었습니다.

⚠️ 면책 조항

이 도구는 연구 목적으로만 사용됩니다. medRxiv의 서비스 약관을 준수하고 책임감 있게 사용해 주시기 바랍니다.