Skip to main content
Glama
kci-mcp-server

kci-mcp-server

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. 인증키 발급 완료 후 아래 환경변수에 설정

Related MCP server: KISTI-MCP

설치 및 빌드

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

Available Tools

5 tools
kci_get_article_detailA

KCI 논문 제어번호(Control Number, 예: ART002358582)로 논문의 상세 정보(저자 소속, 원문 URL, DOI, UCI, FWCI, 피인용 횟수 등)를 조회합니다. 제어번호는 kci_search_articles 결과의 article-id 값입니다.

Inputs: id (required).

kci_get_citation_detailA

저널(학술지) 제어번호로 해당 저널의 등재 정보, 발행 기관 정보, 학술지 변경 이력, 연도별 인용지수 이력(영향력 지수 3/4/5년, SJR, 자기인용비율 등)을 상세 조회합니다.

Inputs: id (required).

kci_get_journal_citationsA

기준년도(year)와 포함년도(years)를 기준으로 저널(학술지)들의 인용지수(영향력 지수, 즉시성 지수, 자기인용 비율 등) 목록을 조회합니다.

Inputs: year (required), years (required), doi, page, +7 more.

kci_search_articlesB

KCI(한국학술지인용색인)에 등재된 논문을 제목, 저자, 저널명 등으로 검색하여 기본 정보(저널 정보, 저자, 초록, 키워드, 피인용 횟수 등)를 조회합니다.

Inputs: title (required), doi, page, author, +14 more.

kci_search_referencesB

특정 제목/저자/기관/연도로 검색되는 논문들이 인용한 참고문헌 목록을 조회합니다.

Inputs: title (required), author, pubiYr, sortNm, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation: searching articles, getting article details, journal citation details, journal citation lists, and reference searching. Descriptions clearly differentiate them.

    Naming Consistency5/5

    All tools follow the consistent pattern 'kci_<verb>_<noun>' (e.g., kci_search_articles, kci_get_article_detail) with all lowercase and underscores.

    Tool Count5/5

    5 tools appropriately cover the core functionalities of a citation index server: search, article details, journal citation details, citation lists, and reference searching. Neither too few nor too many.

    Completeness4/5

    The tool set covers key research workflows (search, article details, citation info). A minor gap might be a dedicated journal search tool, but kci_get_journal_citations partially fills that role. Overall well-scoped.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Integrates with KISTI's ScienceON, NTIS, and DataON APIs to search and retrieve scientific papers, patents, reports, national R\&D projects, and research data.
      19
      Creative Commons Attribution Non Commercial 4.0 International
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and harvesting Korean Citation Index literature, citation indices, and references via REST API and OAI-PMH.
      7
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying citation data from OpenCitations, including references, citations, citation counts, and bibliographic metadata for DOIs.
      342 npm
      MIT