Scholar Search MCP

Claude, Cursor 및 기타 MCP 클라이언트에서 학술 문헌 워크플로우를 위한 MCP 서버입니다.

Semantic Scholar + arXiv를 하나의 통합 도구 세트로 결합하여 빠른 병렬 검색, 정규화된 출력, 소스 인식 중복 제거, 실용적인 연구 유틸리티(인용, 참고 문헌, 저자 그래프, 추천 및 arXiv 소스 다운로드)를 제공합니다.

목차

• 이 프로젝트의 목적

• 데모 영상

• 설치

• 빠른 설정 (Claude Desktop / Cursor)

• 환경 변수

• 도구 목록

• MCP Inspector로 테스트하기

• 기여 방법

• 라이선스

Related MCP server: arXiv Research Assistant MCP Server

이 프로젝트의 목적

대부분의 논문 도구는 하나의 소스나 API 스타일을 선택하도록 강요합니다. scholar-search-mcp는 문헌 검색 및 그래프 검색을 위한 단일 MCP 계층을 제공합니다:

• 하나의 MCP 서버, 여러 학술 소스

• 무료 우선 기본값 (arXiv는 키 없이 작동)

• LLM 친화적인 출력 (후속 추론 및 에이전트 워크플로우용)

• 검색뿐만 아니라 실용적인 연구 작업 수행

• 통합 검색: search_papers는 Semantic Scholar와 arXiv를 병렬로 실행하고 정규화된 제목으로 중복을 제거합니다.

• 연구 그래프 도구: 세부 정보, 인용, 참고 문헌, 저자 프로필/논문 및 추천 기능.

• 배치 + 소스 워크플로우: 최대 500개의 논문을 가져오고 arXiv LaTeX 소스를 다운로드/추출합니다.

• 운영 제어: 내장 캐싱 및 환경 변수 기반 소스 토글(채널 활성화/비활성화).

• 소스 전략: 내장된 Semantic Scholar + arXiv, 기본적으로 무료 우선(arXiv 키 불필요), 더 높은 Semantic Scholar 제한을 위한 선택적 API 키 제공.

데모 영상

에이전트가 Scholar Search MCP를 사용하여 조사 논문을 작성하는 모습.

설치

pip install scholar-search-mcp

Python 3.10+가 필요합니다.

빠른 설정 (Claude Desktop / Cursor)

두 클라이언트 모두에서 동일한 서버 명령을 사용하세요:

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
      }
    }
  }
}

SEMANTIC_SCHOLAR_API_KEY는 선택 사항입니다. Semantic Scholar의 속도 제한을 높이려면 추가하세요:

{
  "mcpServers": {
    "scholar-search": {
      "command": "python",
      "args": ["-m", "scholar_search_mcp"],
      "env": {
        "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "true",
        "SCHOLAR_SEARCH_ENABLE_ARXIV": "true",
        "SEMANTIC_SCHOLAR_API_KEY": "your-key"
      }
    }
  }
}

차이점:

• Claude Desktop: 로컬 설정 파일을 직접 편집합니다.

• Cursor: Cursor 설정 UI(또는 해당 설정 JSON)에 MCP 서버를 추가합니다.

Claude Desktop 설정 파일 위치:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

환경 변수

예시 (arXiv만 사용):

{
  "SCHOLAR_SEARCH_ENABLE_SEMANTIC_SCHOLAR": "false",
  "SCHOLAR_SEARCH_ENABLE_ARXIV": "true"
}

도구 목록

MCP Inspector로 테스트하기

npm install -g @modelcontextprotocol/inspector
mcp-inspector python -m scholar_search_mcp

기여 방법

이슈와 PR은 언제나 환영합니다: 저장소를 포크하고, 브랜치를 생성하고, 유효성 검사/테스트를 추가한 후 명확한 변경 전후 동작을 포함하여 PR을 열어주세요.

라이선스

MIT

참고 문헌

• Semantic Scholar API 문서

• arXiv API 사용자 매뉴얼