Data4library

Data4library

MCP server enabling access to Korea's Library Information Naru API for libraries, including books, loans, stats, and nea

2
Stars
1
Forks
0
Releases

Overview

data4library-mcp은 국립중앙도서관이 제공하는 도서관 정보나루 API를 완전히 활용할 수 있도록 설계된 포괄적인 MCP(Model Context Protocol) 서버입니다. 한국의 전국 공공도서관 데이터, 도서 검색, 대출 현황, 독서 통계 등을 AI 모델에서 쉽게 접근하고 활용하도록 엔드포인트를 래핑하고 도구 간 체이닝을 자동화합니다. 총 25개의 MCP 도구를 통해 도서관 검색, 도서 상세정보, 대출 가능 여부, 인기 도서 및 트렌드 분석, 신착 도서, 지역별 통계, 개인화 추천, 위치 기반 서비스 등 다양한 기능을 제공합니다. 또한 GPS 기반의 내 주변 도서관 검색과 거리 계산(Haversine)을 포함해 실시간 데이터 동기화, 특정 도서의 이용 패턴 분석, 파트너 앱과의 연계 등을 지원합니다. 데이터 입력의 타입 안전성을 보장하기 위해 Zod 스키마 검증을 사용하고, 세션별 사용량 모니터링과 상세 로깅으로 디버깅을 돕습니다. Smithery를 통한 간편 설치, Claude Desktop/Cursor AI와의 연동 설정 등 실무용 워크플로우를 포함하고 있습니다.

Details

Owner
isnow890
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

완전한 API 래핑

도서관 정보나루 API의 25개 엔드포인트를 MCP로 완전히 래핑하여 모든 기능에 접근 가능

스마트 체이닝

도구 간 자동 연계로 복잡한 질의를 쉽고 빠르게 해결

실시간 데이터 동기화

도서관 정보나루와의 실시간 데이터 동기화를 통해 최신 정보 제공

위치 기반 거리 계산 및 근접 검색

내 주변 도서관 검색 및 거리(km) 표기, haversine 기반 거리 계산 및 실시간 정렬

Zod 스키마 검증

입력 값의 타입 안전성 확보 및 에러 방지

세션 통계 및 모니터링

실시간 도구 호출 통계 및 세션 정보 수집/모니터링

오류 처리 및 로깅

상세 로깅 및 디버깅 정보를 제공하여 안정성 향상

시나리오 기반 도구 제안

LLM이 상황에 맞는 도구를 쉽게 선택할 수 있도록 구체적인 시나리오 제공

Audience

시민/기관 포털도서관 현황 및 운영 정보 챗봇, 신간/인기도서 알림 서비스
교육/연구KDC 주제별 독서 트렌드 분석 및 독서 통계 리포트
출판/마케팅인기 장르/도서 발굴 및 트렌드 변화 모니터링
앱/서비스 개발자ISBN 기반 실시간 소장/대출 가능 여부 UX 및 위치 기반 도서관 추천

Tags

data4libraryMCPMCP serverKoreaLibrary Information Naru APIpublic librariesbook searchloan statusreading statisticsnearby searchGPSdistanceHaversinereal-time dataAPI wrapperSmitheryClaude Desktop