kci-openapi-mcp

<!-- mcp-name: io.github.rubato103/kci-openapi-mcp -->

한국연구재단(NRF) KCI(Korea Citation Index) 문헌·인용지수 검색·수집 MCP 서버 + CLI. REST Open API(키워드 검색)와 OAI-PMH(무인증 대량 수확)를 혼용한다. 자매 프로젝트 scienceon-mcp와 동일 아키텍처.

무엇을 하나

• 논문 검색·상세 (서지 · 국문/영문 초록 · 키워드 · 저자/소속)
• OAI-PMH 대량 수확 (인증키 불필요 — 세트+날짜범위)
• 참고문헌 원형 수집 · 저널 인용지수/등재이력 (REST 전용)
• 대량 수집 → xlsx / csv / json / sqlite

두 인터페이스

	REST Open API	OAI-PMH
엔드포인트	…/po/openapi/openApiSearch.kci	…/oai/request
인증	KCI_API_KEY 필요	불필요
질의	키워드 검색(title 필수)	세트+날짜 대량 수확
인용지수·참고문헌	✅	❌
규격: docs/KCI_API_GUIDE.md · docs/KCI_OAI_PMH_GUIDE.md · 설계: docs/ARCHITECTURE.md

현재 상태

• ✅ src/kci_mcp/ 구현 완료 · REST/OAI 라이브 검증 완료 · pytest 22건 + MCP 프로토콜 스모크 통과
• ✅ Claude Desktop(mcpb/manifest.json) + Claude Code(.mcp.json) + 공식 레지스트리(server.json) 지원

MCP 클라이언트에 등록

Claude Code

프로젝트 루트의 .mcp.json 이 자동 인식된다(키는 환경변수로 주입):

export KCI_API_KEY=<발급키>   # 선택 — 없으면 OAI 무인증 도구만 동작
# 또는 어디서나(공개 후):
claude mcp add kci --env KCI_API_KEY=$KCI_API_KEY -- uvx --from git+https://github.com/rubato103/KCI_openAPI kci-mcp

Claude Desktop

• 레지스트리/원클릭: 공식 MCP 레지스트리에서 검색해 설치(공개 후).
• 수동: %APPDATA%/Claude/claude_desktop_config.json 에 추가

{ "mcpServers": { "kci": {
  "command": "uvx",
  "args": ["--from", "git+https://github.com/rubato103/KCI_openAPI", "kci-mcp"],
  "env": { "KCI_API_KEY": "<발급키 또는 비움>", "KCI_OS_TRUST": "1" }
} } }

PyPI / uvx (공개 후)

uvx kci-openapi-mcp        # MCP 서버(stdio)

CLI (로컬 개발)

uv sync                    # venv는 UV_PROJECT_ENVIRONMENT 로 클라우드 폴더 밖 권장
kci identify               # OAI 무인증 — 키 없이 즉시
kci harvest --set ARTI --from 2024-01-01 --until 2024-12-31 --contains 학부모 --max 500
kci search --title 경계선지능 --rows 20   # REST(인증키 필요)
kci collect --config config/borderline_slow.yaml

MCP 도구 (7종)

kci_status · kci_search · kci_detail · kci_references · kci_journal_citation · kci_harvest · kci_collect kci_collect 은 요청 성격·키 유무로 REST↔OAI 자동 선택.

자격증명 / 네트워크

• KCI_API_KEY (open.kci.go.kr 발급) → .env(gitignore) 또는 OS 환경변수. 커밋·로그 금지. OAI는 키 불필요.
• 교육망/사내망 SSL 인터셉션은 truststore로 OS 신뢰저장소를 사용해 통과(검증 유지). KCI_OS_TRUST=0로 비활성.

라이선스

MIT