KCI MCP 서버

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
• STDIO + HTTP: 로컬(Claude Desktop) 및 원격 배포 모두 지원
• TypeScript: 완전한 타입 안전성 및 구조화된 응답

🚀 설치 및 사용 방법

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

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

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

커넥터 추가 방법:

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

https://kci-mcp.fly.dev/mcp?key=YOUR_KCI_API_KEY

💡 KCI API 키 발급: KCI 포털 → 로그인 → Open API 신청 예시 형식: https://kci-mcp.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 설정

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

💡 단축 방법: 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_키>"
      }
    }
  }
}

✅ 설치 확인

🛠️ 도구 목록 (7개)

💬 사용 예시 프롬프트

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

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

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

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

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

🔧 직접 실행 (HTTP 서버 모드)

# HTTP 모드로 실행 (원격 배포용)
KCI_API_KEY=<발급받은_KCI_API_키> node dist/index.js --http
# → http://localhost:3001/mcp
# → http://localhost:3001/health

📋 환경변수

📚 KCI Open API 정보

🐳 Docker 배포

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

📄 라이선스

MIT

👤 만든 사람