kci-mcp-server
This server provides access to the Korea Citation Index (KCI) Open API, translating XML responses to JSON via MCP tools. Here's what you can do:
Search Articles (
kci_search_articles): Find academic papers by title, author, journal name, keyword, abstract, DOI, affiliation, institution, and date range. Returns journal details, authors, abstracts, keywords, and citation counts.Get Article Detail (
kci_get_article_detail): Retrieve comprehensive details for a specific article using its KCI Control Number (e.g.,ART002358582), including author affiliations, full-text URL, DOI, UCI, FWCI, and citation counts.Search References (
kci_search_references): Look up the reference lists of articles matching a given title, author, institution, or publication year — i.e., see what sources those papers cited.Get Journal Citations (
kci_get_journal_citations): Query citation index metrics (impact factor, immediacy index, self-citation rate) for journals by base year and inclusion window (2–5 years).Get Citation Detail (
kci_get_citation_detail): Retrieve detailed citation history for a specific journal by its Control Number, including registration info, publisher details, name change history, and yearly citation index records (3/4/5-year impact factor, SJR, self-citation ratio).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kci-mcp-server search references for 'AI ethics' in KCI journals"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)에 공문 발송
인증키 발급 완료 후 아래 환경변수에 설정
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.jsWindows 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.jsmacOS/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 | 설명 |
|
| 제목/저자/저널명 등으로 논문 기본 정보 검색 |
|
| 논문 제어번호로 상세 정보 조회 (초록, 키워드, DOI, FWCI, 피인용 횟수 등) |
|
| 논문의 참고문헌 목록 조회 |
|
| 기준년도별 저널 인용지수(영향력 지수 등) 목록 조회 |
|
| 저널 제어번호로 인용지수 상세 이력 조회 |
모든 도구는 KCI Open API가 XML로 응답하는 데이터를 JSON으로 변환하여 반환합니다.
참고
KCI Open API는 XML 응답만 지원하며, 이 서버는 내부적으로 XML을 JSON으로 파싱해 반환합니다.
인증키가 만료되었거나 잘못된 경우, KCI가 반환하는 원본 오류 메시지를 그대로 전달합니다.
KCI 서버는
displayCount파라미터 값과 무관하게 기본 10건을 반환하는 경우가 있습니다(KCI 서버 자체의 동작이며 클라이언트 코드 문제가 아님). 정확한 전체 건수는 응답의result.total값을 참고하세요.
Available Tools
5 toolskci_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
Scored across 5 tools
Each tool targets a distinct operation: searching articles, getting article details, journal citation details, journal citation lists, and reference searching. Descriptions clearly differentiate them.
All tools follow the consistent pattern 'kci_<verb>_<noun>' (e.g., kci_search_articles, kci_get_article_detail) with all lowercase and underscores.
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.
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
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
OpenCitations MCP — citation index (COCI + general Index API).
Search 250M+ academic works, citation graphs, DOIs, and institutional research via OpenAlex.
Korean accounting standards, audit, tax and legal sources and rulings, with citation checks
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables Claude to search and analyze Korean academic papers using the Korea Citation Index (KCI) Open API. Supports paper search, detailed metadata retrieval, reference analysis, author and keyword searches, and citation index queries.1-
- AlicenseNot gradedqualityCmaintenanceIntegrates with KISTI's ScienceON, NTIS, and DataON APIs to search and retrieve scientific papers, patents, reports, national R\&D projects, and research data.19Creative Commons Attribution Non Commercial 4.0 International
- AlicenseAqualityBmaintenanceEnables searching and harvesting Korean Citation Index literature, citation indices, and references via REST API and OAI-PMH.74MIT
- AlicenseNot gradedqualityCmaintenanceEnables querying citation data from OpenCitations, including references, citations, citation counts, and bibliographic metadata for DOIs.342 npmMIT