kci-mcp-server

KCI(한국학술지인용색인, Korea Citation Index) Open API를 호출하는 MCP(Model Context Protocol) 서버입니다.

사전 준비: KCI Open API 인증키 발급

KCI 포털(https://www.kci.go.kr) 회원가입
Open API 인증키 신청서 작성 후 한국연구재단(kciadmin@nrf.re.kr)에 공문 발송
인증키 발급 완료 후 아래 환경변수에 설정

설치 및 빌드

1. 프로젝트 클론

git clone https://github.com/iapke486-arch/mcp-server.git
cd mcp-server

npm install
npm run build

실행

직접 실행 (테스트)

KCI_API_KEY=발급받은인증키 node --use-system-ca build/index.js

Windows PowerShell:

$env:KCI_API_KEY = "발급받은인증키"
node --use-system-ca build/index.js

--use-system-ca 플래그가 필요한 이유: 사내망/회사 프록시가 TLS 트래픽을 검사(SSL 인터셉션)하는 환경에서는 Node.js의 기본 인증서 목록에 없는 사설 루트 인증서가 응답에 포함되어 self-signed certificate in certificate chain 오류로 요청이 실패할 수 있습니다. --use-system-ca(Node 22+)는 Windows 인증서 저장소를 함께 신뢰하도록 하여 이 문제를 해결합니다. 이런 프록시 환경이 아니라면 없어도 무방합니다.

Claude Desktop / Claude Code 설정

Claude Desktop

claude_desktop_config.json(보통 %APPDATA%\Claude\claude_desktop_config.json)에 아래와 같이 등록합니다.

{
  "mcpServers": {
    "kci": {
      "type": "stdio",
      "command": "node",
      "args": ["--use-system-ca", "/path/to/mcp-server/build/index.js"],
      "env": {
        "KCI_API_KEY": "발급받은인증키"
      }
    }
  }
}

경로 예시:

Windows: C:/Users/YourName/Documents/projects/mcp-server/build/index.js
macOS/Linux: /home/username/projects/mcp-server/build/index.js

Claude Code CLI

claude mcp add --env KCI_API_KEY=발급받은인증키 -- node --use-system-ca /path/to/mcp-server/build/index.js

# 모든 프로젝트에서 사용하려면 사용자 전역 스코프로 등록
claude mcp add --scope user --env KCI_API_KEY=발급받은인증키 -- node --use-system-ca /path/to/mcp-server/build/index.js

연결 확인

Claude Code: /mcp 목록에서 kci 서버가 ✓ Connected 상태인지 확인하세요.

제공 도구 (Tools)

Tool	KCI API Code	설명
`kci_search_articles`	`articleSearch`	제목/저자/저널명 등으로 논문 기본 정보 검색
`kci_get_article_detail`	`articleDetail`	논문 제어번호로 상세 정보 조회 (초록, 키워드, DOI, FWCI, 피인용 횟수 등)
`kci_search_references`	`referenceSearch`	논문의 참고문헌 목록 조회
`kci_get_journal_citations`	`citation`	기준년도별 저널 인용지수(영향력 지수 등) 목록 조회
`kci_get_citation_detail`	`citationDetail`	저널 제어번호로 인용지수 상세 이력 조회

모든 도구는 KCI Open API가 XML로 응답하는 데이터를 JSON으로 변환하여 반환합니다.

참고

KCI Open API는 XML 응답만 지원하며, 이 서버는 내부적으로 XML을 JSON으로 파싱해 반환합니다.
인증키가 만료되었거나 잘못된 경우, KCI가 반환하는 원본 오류 메시지를 그대로 전달합니다.
KCI 서버는 displayCount 파라미터 값과 무관하게 기본 10건을 반환하는 경우가 있습니다(KCI 서버 자체의 동작이며 클라이언트 코드 문제가 아님). 정확한 전체 건수는 응답의 result.total 값을 참고하세요.