kci-mcp-server

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

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

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

설치 및 빌드

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_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 값을 참고하세요.

---

이 완성본을 **README.md 파일에 전체 교체**하려면, VS Code나 텍스트 에디터에서:

1. 현재 README.md 파일 전체 선택 (Ctrl+A)
2. 위 내용 전체 복사 후 붙여넣기
3. 저장 (Ctrl+S)
- 인증키가 만료되었거나 잘못된 경우, KCI가 반환하는 원본 오류 메시지를 그대로 전달합니다.
- KCI 서버는 displayCount 파라미터 값과 무관하게 기본 10건을 반환하는 경우가 있습니다(KCI 서버 자체의 동작이며 클라이언트 코드 문제가 아님). 정확한 전체 건수는 응답의 result.total 값을 참고하세요.