MCP 服务器

scienceon-mcp

Enables searching and collecting academic literature metadata from KISTI ScienceOn via Claude or CLI, supporting various document types and export formats.

README

scienceon-mcp

KISTI ScienceOn OpenAPI 문헌 검색·메타데이터 수집기 — MCP 서버 + CLI. 자기 ScienceOn API 키만 발급받으면 누구나 Claude(또는 CLI)에서 국내외 논문·보고서 서지 메타데이터를 검색·수집할 수 있습니다.

An MCP server + CLI for KISTI ScienceOn OpenAPI. Bring your own API key and let Claude search & collect academic literature metadata in any project.

무엇을 할 수 있나

🔎 검색: 논문(ARTI)·보고서(REPORT) 등 서지 메타데이터 검색
📄 상세: 제어번호(CN)로 초록·서지 전체 조회
💾 수집: 결과를 xlsx / csv / json / sqlite 로 저장
🤖 두 가지 사용법: Claude에서 도구 호출(MCP) · 터미널 배치(CLI) — 같은 코어 공유

지원 티켓: ARTI 논문 · REPORT 보고서 · ATT 동향 · RESEARCHER 연구자 · ORGAN 연구기관 (계정 구독 범위에 따름)

요구사항

Python 3.10+
uv (패키지 관리)
ScienceOn API 자격증명 (아래 발급 방법)

1) API 키 발급

ScienceOn 회원가입·로그인
API Gateway → 인증키 발급 신청 → 승인 후 인증키·Client ID 발급
인증키관리에서 신청 MAC 주소 등록, IP관리에서 호출 PC의 공인 IP 등록
사용할 서비스 콘텐츠(티켓) 체크 (논문/보고서 등)

2) 설치 (uv, 클라우드 폴더 주의)

이 저장소가 OneDrive 등 클라우드 동기화 폴더에 있다면 venv를 폴더 밖에 두세요 (동기화 충돌·파일락 방지). uv는 UV_PROJECT_ENVIRONMENT 로 환경 위치를 지정합니다.

# 예: venv 를 클라우드 밖 로컬 경로에 생성
export UV_PROJECT_ENVIRONMENT="$HOME/.venvs/scienceon-mcp"   # Windows(PowerShell): $env:UV_PROJECT_ENVIRONMENT="C:\Users\<you>\.venvs\scienceon-mcp"
uv sync

3) 자격증명 설정

.env.example 을 복사해 .env 작성 (커밋 금지):

SCIENCEON_AUTH_KEY=발급_32자리_인증키
SCIENCEON_CLIENT_ID=발급_client_id
SCIENCEON_MAC_ADDRESS=AA-BB-CC-DD-EE-FF
SCIENCEON_ACCOUNT_ID=신청자_아이디

4) Claude에 MCP 연결

Claude Desktop (claude_desktop_config.json) — 자격증명은 env 블록으로 전달:

{
  "mcpServers": {
    "scienceon": {
      "command": "C:\\Users\\<you>\\.venvs\\scienceon-mcp\\Scripts\\python.exe",
      "args": ["-m", "scienceon_mcp.server"],
      "env": {
        "SCIENCEON_AUTH_KEY": "...",
        "SCIENCEON_CLIENT_ID": "...",
        "SCIENCEON_MAC_ADDRESS": "AA-BB-CC-DD-EE-FF"
      }
    }
  }
}

Claude Code:

claude mcp add scienceon -- "C:\Users\<you>\.venvs\scienceon-mcp\Scripts\python.exe" -m scienceon_mcp.server

연결되면 Claude에서 scienceon_search, scienceon_detail, scienceon_export, scienceon_status 도구를 사용할 수 있습니다.

5) CLI 사용 (배치·재현)

uv run scienceon status                                   # 토큰/연결 확인
uv run scienceon search --target ARTI --query "인공지능" --year 2015~2024 --rows 100
uv run scienceon collect --config config/search.example.yaml   # 설정 기반 대량 수집