KCI MCP 서버

KCI(한국학술지인용색인) Open API 기반 학술 논문 검색·분석 MCP 서버

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

✨ 주요 특징

• 7개 도구: 논문 검색·상세·참고문헌·인용지수·저자검색·키워드검색 완전 지원
• 공식 API 준수: open.kci.go.kr 공식 엔드포인트 및 MetaData XML 구조 사용
• KCI 5종 API: articleSearch / articleDetail / referenceSearch / citation / citationDetail
• 개인 API 키 지원: URL ?key= 파라미터로 각자 KCI API 키 입력
• STDIO + HTTP: 로컬(Claude Desktop) 및 원격 배포 모두 지원
• 자동 배포: GitHub Actions → Fly.io 자동 배포 파이프라인

🌐 서버 상태

| 항목 | 내용 | |------|------| | 서버 URL | https://kci-mcp-korea.fly.dev | | 헬스체크 | https://kci-mcp-korea.fly.dev/health | | 리전 | nrt - Tokyo, Japan (도쿄) | | 상태 | 🟢 운영 중 |

🚀 설치 및 사용 방법

방법 1: Claude.ai 웹에서 바로 사용 (설치 없음, 가장 쉬움)

아무것도 설치하지 않고, 주소 하나만 입력하면 됩니다.

⚠️ Claude Pro / Max / Team / Enterprise 요금제 필요 (Free는 커넥터 1개만 가능)

커넥터 추가 방법:

1. claude.ai에 로그인합니다.
2. 왼쪽 사이드바 하단의 본인 이름을 클릭합니다.
3. "설정" (또는 Settings)을 선택합니다.
4. "커넥터" (또는 Connectors) 메뉴로 들어갑니다.
5. "커스텀 커넥터 추가" 버튼을 클릭합니다.
6. 아래 내용을 입력합니다:
   • 이름: kci-mcp (원하는 이름 아무거나 OK)
   • URL: 아래 주소에서 <발급받은_KCI_API_키> 부분을 본인의 KCI API 인증키로 바꿔서 입력하세요:

https://kci-mcp-korea.fly.dev/mcp?key=<발급받은_KCI_API_키>

💡 KCI API 키 발급: KCI 포털 → 로그인 → Open API 신청 (무료)
예시 형식: https://kci-mcp-korea.fly.dev/mcp?key=<발급받은_KCI_API_키>

7. 저장 후 Claude 채팅창으로 돌아가면 즉시 사용 가능합니다.

사용 예시:

AI 교육 관련 KCI 논문 최근 10건 검색해줘
2024년 KCI 인용지수 상위 20개 학술지 알려줘

방법 2: Claude Desktop에 로컬 설치

사전 준비

• Node.js 18+

설치

git clone https://github.com/auraweon7-ship-it/kci-mcp.git
cd kci-mcp
npm install

Claude Desktop 설정

아래 경로의 설정 파일을 엽니다:

| OS | 경로 | |----|------| | Windows | %APPDATA%\\Claude\\claude_desktop_config.json | | Mac | ~/Library/Application Support/Claude/claude_desktop_config.json |

💡 단축 방법: Claude Desktop → Settings → Developer → Edit Config 클릭

설정 파일에 아래 내용을 추가합니다 (본인의 KCI API 키로 교체):

{
  "mcpServers": {
    "kci-mcp": {
      "command": "node",
      "args": ["/절대경로/kci-mcp/dist/index.js"],
      "env": {
        "KCI_API_KEY": "<발급받은_KCI_API_키>"
      }
    }
  }
}

⚠️ Windows 경로는 역슬래시를 두 번 써야 합니다: C:\\Users\\사용자명\\kci-mcp\\dist\\index.js

💡 KCI API 키 발급: KCI 포털 → 로그인 → Open API 신청 (무료)

Claude Desktop을 완전히 재시작하면 채팅창 하단에 🔨 아이콘이 나타납니다.

방법 3: Claude Code (터미널, 개발자용)

# 전역 등록 (모든 프로젝트에서 사용, API 키를 본인 키로 교체)
claude mcp add-json kci-mcp \
  '{"type":"stdio","command":"node","args":["/절대경로/kci-mcp/dist/index.js"],"env":{"KCI_API_KEY":"<발급받은_KCI_API_키>"}}' \
  --scope user

또는 프로젝트 루트에 .mcp.json 파일 생성:

{
  "mcpServers": {
    "kci-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "KCI_API_KEY": "<발급받은_KCI_API_키>"
      }
    }
  }
}

💡 KCI API 키 발급: KCI 포털 → 로그인 → Open API 신청 (무료)

✅ 설치 확인

| 클라이언트 | 확인 방법 | |---|---| | claude.ai 웹 | 채팅창 하단 + → Connectors에서 kci-mcp 활성 상태 확인 | | Claude Desktop | 입력창 하단 🔨 아이콘 클릭 → 도구 목록에 kci_search_articles 등 7개 표시 | | Claude Code | 터미널에서 claude mcp list 실행 |

🛠️ 도구 목록 (7개)

| 도구 | 설명 | 주요 파라미터 | |------|------|--------------| | kci_search_articles | 논문 기본 검색 | title, author, journal, keyword, dateFrom, dateTo | | kci_article_detail | 논문 상세 조회 | id (ART번호) | | kci_search_references | 참고문헌 검색 | title, author, pubiYr | | kci_get_citations | 인용지수 목록 | year, years (2-5) | | kci_citation_detail | 학술지 IF 상세 | id (SER번호) | | kci_search_by_author | 저자별 논문 검색 | author, affiliation, dateFrom, dateTo | | kci_search_by_keyword | 키워드 논문 검색 | keyword, journal, dateFrom, dateTo |

💬 사용 예시 프롬프트

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

# 저자 검색
홍길동 교수 논문 목록 찾아줘

# 키워드 검색
딥러닝 키워드 논문 2022년 이후로 검색해줘

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

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

🔧 직접 배포 (선택사항)

환경변수

| 변수 | 필수 | 기본값 | 설명 | |------|------|--------|------| | KCI_API_KEY | O | (직접 입력 필수) | KCI Open API 인증키 — 발급 | | PORT | X | 3001 | HTTP 서버 포트 | | CORS_ORIGIN | X | * | CORS 허용 오리진 | | TRANSPORT | X | stdio | http 또는 stdio |

HTTP 서버 직접 실행

KCI_API_KEY=<발급받은_KCI_API_키> node dist/index.js --http
# → http://localhost:3001/mcp?key=<KCI_API_키>
# → http://localhost:3001/health

Docker 배포

docker build -t kci-mcp .
docker run -e KCI_API_KEY=<발급받은_KCI_API_키> -p 3001:3001 kci-mcp

Fly.io 배포 (GitHub Actions 자동화 포함)

# flyctl 설치 및 로그인
iwr https://fly.io/install.ps1 -useb | iex  # Windows
curl -L https://fly.io/install.sh | sh       # Mac/Linux

flyctl auth login
flyctl apps create kci-mcp-korea
flyctl deploy

GitHub Secrets에 FLY_API_TOKEN 등록 시 main 브랜치 push마다 자동 배포됩니다.

📚 KCI Open API 정보

| 항목 | 값 | |------|-----| | 공식 엔드포인트 | https://open.kci.go.kr/po/openapi/openApiSearch.kci | | 응답 형식 | XML (UTF-8, MetaData 루트) | | API 종류 | articleSearch / articleDetail / referenceSearch / citation / citationDetail | | KCI 포털 | https://www.kci.go.kr/kciportal/main.kci |

📄 라이선스

MIT

👤 만든 사람