korea-academic-mcp

국내 학술 데이터베이스 KCI · DBpia · RISS를 각 기관의 공식 Open API로 검색하는 MCP 서버입니다. Smithery 툴박스에 얹으면 게이트웨이 URL(mcp.smithery.run/<계정>)을 통해 Claude에서 Google Scholar처럼 국내 논문이 자동 검색됩니다.

제공 도구:

⚠️ 스크래핑 없음. 세 도구 모두 공식 REST API만 호출합니다. 원문 다운로드·상업적 재배포는 각 기관 약관/구독 범위를 따르세요. 이 서버는 검색·서지 메타데이터 용도입니다.

0. 사전 준비 — API 키 발급 (본인이 직접)

키 발급은 계정 인증이 걸린 작업이라 반드시 본인이 하셔야 합니다.

1. 로컬 테스트 (선택)

npm install
cp .env.example .env      # 키 입력
npm run dev               # smithery dev — 로컬에서 도구 호출 테스트

빌드 없이 타입만 확인하려면:

npm run typecheck

2. Smithery 배포 (GitHub 연결형)

runtime: typescript 서버는 GitHub 저장소를 Smithery가 빌드·호스팅합니다.

1. 이 폴더를 GitHub 저장소로 push (예: qvism9/korea-academic-mcp)

2. https://smithery.ai/new 접속 → Deploy / Continue with GitHub

3. 저장소 선택 → Smithery가 smithery.yaml(runtime: typescript)을 읽어 자동 빌드

4. 배포 완료 시 @qvism9/korea-academic 형태의 서버가 생성됨

배포 시 요구되는 파일은 이미 다 들어 있습니다:

• smithery.yaml → runtime: typescript

• package.json → "module": "./src/index.ts", "type": "module"

• src/index.ts → export const configSchema + export default createServer({ config })

3. 설정값(config) 입력

Smithery 서버 페이지의 Config 화면(또는 툴박스 연결 시)에서 키를 넣습니다. Claude가 세션마다 이 config를 서버로 주입합니다.

KCI/RISS 튜닝 포인트: 키 발급 후 받는 **명세서(Open API 규격)**에 적힌 엔드포인트·파라미터명이 위 기본값과 다르면, 코드 수정 없이 config 값만 맞추면 됩니다. kci_search 결과가 0건이면 대개 kciQueryParam/kciApiCode 불일치가 원인입니다.

4. 툴박스에 추가 → Claude에서 사용

1. Smithery 대시보드에서 배포된 korea-academic 서버를 본인 툴박스(qvism9)에 Add

2. 게이트웨이 URL(mcp.smithery.run/qvism9)이 자동 반영

3. Claude 세션에서 커넥터를 새로고침(또는 토글 OFF→ON)하면 dbpia_search · kci_search · riss_search가 나타남

4. 이제 "디지털 카르텔 국내 논문 찾아줘" → DBpia·KCI·RISS 자동 검색

파일 구조

korea-academic-mcp/
├── smithery.yaml       # runtime: typescript
├── package.json        # module 엔트리 + smithery 스크립트
├── tsconfig.json
├── .env.example        # 로컬 테스트용 키 템플릿
├── .gitignore
├── README.md
└── src/
    └── index.ts        # configSchema + 3개 도구(dbpia/kci/riss)