KCI MCP Server v2.0

KCI(한국학술지인용색인) Open API 기반 학술 논문 검색·분석 MCP 서버
한국연구재단의 KCI Open API를 활용하여 국내 학술 논문 검색, 상세 조회, 참고문헌 분석, 인용지수 조회를 Claude AI와 통합합니다.

✨ 주요 기능 (7개 도구)

| 도구명 | 설명 | |--------|------| | kci_search_articles | 논문 통합 검색 (전체/제목/저자/키워드/초록/학술지) | | kci_get_article_detail | 논문 상세 조회 (초록, 참고문헌 포함) | | kci_search_references | 논문의 참고문헌 목록 조회 | | kci_get_citation_index | 학술지 인용지수(IF, CiteScore 등) 조회 | | kci_get_citation_detail | 피인용 논문 목록 조회 | | kci_search_by_author | 저자명으로 논문 검색 | | kci_search_by_keyword | 키워드로 논문 검색 |

🚀 빠른 시작

Claude.ai 커넥터 연결

URL: https://kci-mcp-korea.fly.dev/mcp?key=54131726

⚠️ Claude Pro / Max / Team / Enterprise 요금제 필요

로컬 실행 (Claude Desktop)

git clone https://github.com/<your-username>/kci-mcp-korea
cd kci-mcp-korea
npm install
npm run build

claude_desktop_config.json 설정:

{
  "mcpServers": {
    "kci-mcp": {
      "command": "node",
      "args": ["/절대경로/kci-mcp-korea/dist/index.js"],
      "env": {
        "KCI_API_KEY": "54131726"
      }
    }
  }
}

🛫 Fly.io 배포

사전 조건

• flyctl 설치
• Fly.io 계정 로그인: flyctl auth login

최초 배포

# 1. 앱 생성 (최초 1회)
flyctl apps create kci-mcp-korea

# 2. API 키 시크릿 설정
flyctl secrets set KCI_API_KEY=54131726 --app kci-mcp-korea

# 3. nrt(도쿄) 리전으로 배포
flyctl deploy --app kci-mcp-korea --region nrt

업데이트 배포

flyctl deploy --app kci-mcp-korea

상태 확인

flyctl status --app kci-mcp-korea
flyctl logs --app kci-mcp-korea
curl https://kci-mcp-korea.fly.dev/health

💬 사용 예시

# 논문 검색
AI 교육 관련 최신 논문 10건 검색해줘

# 저자 검색
박정원 교수 KCI 논문 목록 찾아줘

# 키워드 검색
ChatGPT 키워드 논문 2023년 이후로 검색해줘

# 인용지수 조회
2024년 KCI 인용지수 상위 20개 학술지 알려줘

# 논문 상세 조회 (검색 결과의 articleId 사용)
ART002358582 논문 상세 정보 보여줘

# 피인용 분석
ART002358582 논문을 인용한 후속 논문 목록 알려줘

🔧 환경 변수

| 변수명 | 설명 | 기본값 | |--------|------|--------| | KCI_API_KEY | KCI Open API 키 (필수) | - | | TRANSPORT | 실행 모드 (stdio | http) | stdio | | PORT | HTTP 서버 포트 | 3001 |

📡 API 엔드포인트

• POST /mcp — MCP 프로토콜 처리
• GET /health — 헬스체크

⚙️ 타임아웃 해결 (IAD → nrt 리전)

기존 IAD(미국 동부) 리전 배포 시 Claude.ai 타임아웃 문제가 발생하였습니다.
nrt(도쿄) 리전으로 배포하면 한국-일본 간 레이턴시(~50ms)로 해결됩니다.

# 기존 IAD 앱 삭제 후 nrt로 재배포
flyctl apps destroy kci-mcp --yes
flyctl apps create kci-mcp-korea
flyctl secrets set KCI_API_KEY=54131726 --app kci-mcp-korea
flyctl deploy --app kci-mcp-korea --region nrt

📜 라이선스

MIT License
한국외국어대학교 중국언어문화학부 박정원 교수 연구실