loading…
Search for a command to run...
loading…
Unified academic paper search MCP server integrating OpenAlex, Semantic Scholar, CrossRef, and arXiv APIs, enabling Claude to search and analyze over 500 millio
Unified academic paper search MCP server integrating OpenAlex, Semantic Scholar, CrossRef, and arXiv APIs, enabling Claude to search and analyze over 500 million scholarly papers.
License: MIT Python 3.11+ FastMCP Fly.io
통합 해외 학술 논문 검색 MCP 서버 - OpenAlex, Semantic Scholar, CrossRef, arXiv API 통합
GitHub 푸시만으로 자동 배포!
GitHub에 푸시
cd global-papers-mcp
git init && git add . && git commit -m "Initial commit"
git remote add origin https://github.com/YOUR_USERNAME/global-papers-mcp.git
git push -u origin main
Railway 연결
global-papers-mcp 선택 → Deploy Now도메인 확인
https://xxx.up.railway.app/mcpClaude.ai 연결
완료! 🎉
상세 가이드: RAILWAY_DEPLOY.md
자동 배포 스크립트:
# Mac/Linux
./deploy.sh
# Windows
deploy.bat
상세 가이드: ONE_CLICK_DEPLOY.md
Claude.ai에서 전 세계 5억+ 학술 논문을 통합 검색하는 MCP 서버
Claude.ai에서 해외 학술 논문을 검색하고 분석할 수 있는 MCP (Model Context Protocol) 서버입니다. 4개의 주요 학술 API를 통합하여 포괄적인 논문 검색 기능을 제공합니다.
openalex_search_papers - 논문 검색openalex_get_paper_detail - 논문 상세 정보openalex_get_author - 저자 정보 조회openalex_search_institutions - 기관 검색semantic_search_papers - 논문 검색semantic_get_paper_detail - 논문 상세 정보semantic_get_citations - 인용 논문 조회semantic_get_references - 참고문헌 조회crossref_search_works - 논문 검색crossref_get_work_by_doi - DOI로 논문 조회crossref_search_journals - 저널 검색arxiv_search_papers - 논문 검색arxiv_get_paper_detail - 논문 상세 정보# 1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/global-papers-mcp.git
cd global-papers-mcp
# 2. 의존성 설치
pip install -r requirements.txt
# 3. 환경 변수 설정 (선택)
cp .env.example .env
# .env 파일에서 SEMANTIC_SCHOLAR_API_KEY 설정 (선택사항)
# 4. 로컬 테스트 실행
python server.py
# 1. Fly.io CLI 설치
curl -L https://fly.io/install.sh | sh
# 2. Fly.io 로그인
flyctl auth login
# 3. 앱 생성 (도쿄 리전 사용으로 latency 최소화)
flyctl launch --no-deploy
# 4. 리전을 Tokyo(nrt)로 변경
flyctl regions set nrt
# 5. 배포
flyctl deploy
# 6. API 키 설정 (Semantic Scholar 사용 시)
flyctl secrets set SEMANTIC_SCHOLAR_API_KEY=your_api_key_here
# 7. MCP URL 확인
flyctl info
# URL 예시: https://global-papers-mcp.fly.dev/mcp
가장 간단하고 빠른 방법입니다!
먼저 Fly.io에 배포를 완료하세요 (위 Fly.io 배포 참고)
# 배포 후 MCP URL 확인
flyctl info
출력 예시:
Hostname = global-papers-mcp.fly.dev
MCP URL: https://global-papers-mcp.fly.dev/mcp (끝에 /mcp 필수!)
웹 브라우저에서 https://claude.ai 접속 (또는 모바일 앱 실행)
웹 (데스크톱):
Settings (설정) 선택모바일 (iOS/Android):
Settings (설정) 선택Connectors 또는 Integrations 메뉴 클릭Features → Model Context Protocol 선택Add Connector 또는 + Add 버튼 클릭
다음 정보를 정확히 입력:
| 필드 | 입력 내용 |
|---|---|
| Name | Global Papers (원하는 이름) |
| URL | https://your-app-name.fly.dev/mcp |
⚠️ 중요: URL 끝에 반드시 /mcp 포함!
예시:
https://global-papers-mcp.fly.dev/mcphttps://global-papers-mcp.fly.devConnect 또는 Save 버튼 클릭Connectors 목록에서 확인:
실제 사용 테스트:
새 대화를 시작하고 다음 명령어 입력:
"OpenAlex에서 machine learning 관련 논문 5개 검색해줘"
Claude가 논문 검색 결과를 반환하면 성공! 🎉
로컬 PC에서 Claude Desktop 앱을 사용하는 경우
로컬 PC에서 Claude Desktop 앱을 사용하는 경우
설정 파일 위치 찾기
운영체제별 경로:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/claude/claude_desktop_config.json설정 파일 열기
Mac/Linux:
# 파일이 없으면 생성
mkdir -p ~/Library/Application\ Support/Claude/
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows:
notepad %APPDATA%\Claude\claude_desktop_config.json
MCP 서버 추가
다음 내용을 입력하거나 기존 파일에 추가:
{
"mcpServers": {
"global-papers": {
"url": "https://global-papers-mcp.fly.dev/mcp"
}
}
}
여러 MCP 서버를 사용하는 경우:
{
"mcpServers": {
"global-papers": {
"url": "https://global-papers-mcp.fly.dev/mcp"
},
"kci-papers": {
"url": "https://kci-mcp-korea.fly.dev/mcp"
}
}
}
파일 저장 및 Claude Desktop 재시작
연결 확인
Claude Desktop에서 새 대화 시작 후:
"사용 가능한 도구를 보여줘"
Global Papers MCP 도구들이 표시되면 성공!
Fly.io 없이 로컬에서만 실행하는 경우
로컬 서버 실행 준비
cd /path/to/global-papers-mcp
pip install -r requirements.txt
설정 파일 수정
claude_desktop_config.json:
{
"mcpServers": {
"global-papers": {
"command": "python",
"args": ["/absolute/path/to/global-papers-mcp/server.py"]
}
}
}
⚠️ 주의:
C:\\Users\\YourName\\global-papers-mcp\\server.py/Users/YourName/global-papers-mcp/server.pyClaude Desktop 재시작
설정 파일 저장 후 앱 재시작
서버 자동 실행
Claude Desktop이 실행될 때 자동으로 로컬 서버가 시작됩니다.
Claude.ai (웹/모바일):
Claude Desktop:
"연결된 MCP 서버를 보여줘"
기본 검색:
"OpenAlex에서 transformer architecture 관련 논문 5개 검색해줘"
DOI 조회:
"CrossRef에서 이 DOI의 논문을 조회해줘: 10.1038/s41586-021-03819-2"
arXiv 검색:
"arXiv에서 cs.AI 카테고리의 최신 논문 10개 보여줘"
인용 관계 추적:
"Semantic Scholar에서 'Attention is All You Need' 논문을 검색하고, 이 논문을 인용한 주요 논문들을 찾아줘"
원인 1: URL 오류
/mcp 엔드포인트 누락/mcp 추가원인 2: 서버 미실행
# Fly.io 서버 상태 확인
flyctl status
# 서버가 중지되어 있으면
flyctl apps restart
원인 3: 방화벽 차단
Claude.ai:
Claude Desktop:
원인: 리전 문제
# 현재 리전 확인
flyctl regions list
# Tokyo(nrt) 리전으로 변경
flyctl regions set nrt
flyctl deploy
---## API 키 설정
대부분의 API는 키 없이 사용 가능하나, Semantic Scholar는 API 키 사용 시 rate limit이 완화됩니다.
.env 파일 또는 환경 변수에 설정Claude.ai에서 다음과 같이 사용:
"transformer 아키텍처 관련 최신 논문을 OpenAlex에서 검색해줘"
"이 DOI의 논문을 CrossRef에서 조회해줘: 10.1038/nature12345"
"arXiv에서 quantum computing 관련 최신 프리프린트 찾아줘"
"Semantic Scholar에서 이 논문을 인용한 논문들을 찾아줘"
MIT License
이슈 및 PR 환영합니다!
Добавь это в claude_desktop_config.json и перезапусти Claude Desktop.
{
"mcpServers": {
"global-papers-mcp": {
"command": "npx",
"args": []
}
}
}