정보나루 도서검색 MCP

도서관 정보나루 API를 MCP 도구로 제공하는 Node.js 서버입니다.

이 프로젝트는 도서관 정보나루 운영기관이 제공하는 공식 MCP와 무관한 독립 오픈소스 프로젝트입니다.

운영 안내 최근 정보나루 API에서 응답 지연과 타임아웃이 간헐적으로 관찰되고 있습니다. 도구 호출이 실패하거나 늦어질 때에는 이 MCP 서버와 정보나루 API 상태를 함께 확인하세요.

English documentation

제공 도구

현재 27개 도구를 등록합니다.

도서관

search_libraries: 지역·도서관명으로 공공도서관 검색
search_nearby_libraries: 좌표에서 가까운 도서관을 거리순으로 검색
search_library_codes: 도서관명·지역명으로 libCode 검색
get_library_info: 도서관 통합정보 조회

도서·소장

search_books: 제목·저자·출판사·주제별 도서 검색
get_book_detail: ISBN으로 도서 상세정보 조회
search_libraries_by_book: 특정 도서를 소장한 도서관 검색
check_book_availability: 특정 도서관의 소장 여부와 전일 기준 대출 가능 여부 조회
get_new_arrival_books: 도서관별 신착도서 조회

통계·분석

get_usage_trend: 도서관별 대출·반납 추이 조회
get_reading_quantity: 지역별 독서량 조회
search_items: 도서관별 장서·대출 데이터 조회
get_book_usage_analysis: 도서 이용 분석 조회
get_book_keywords: 도서 키워드 조회

코드 조회

get_region_codes: 지역 코드 목록
get_detailed_region_codes: 세부 지역 코드 목록
search_detailed_region_codes: 세부 지역 코드 검색
get_subject_codes: KDC 대분류 코드 목록
get_detailed_subject_codes: KDC 세부 분류 코드 목록
search_detailed_kdc_codes: KDC 세부 분류 코드 검색

설치

준비 사항

Node.js 18 이상
도서관 정보나루 API 키

API 키는 정보나루 로그인 후 마이페이지 > 인증키에서 신청할 수 있습니다. 호출 한도와 서버 IP 등록 정책은 정보나루의 최신 안내를 따르세요.

NPX

MCP 클라이언트 설정에 다음 서버를 추가합니다.

{
  "mcpServers": {
    "data4library-mcp": {
      "command": "npx",
      "args": ["-y", "@isnow890/data4library-mcp"],
      "env": {
        "LIBRARY_API_KEY": "your-api-key"
      }
    }
  }
}

LIBRARY_API_TIMEOUT_MS로 원천 요청 제한 시간을 조정할 수 있습니다. 기본값은 10초이며 50~60000ms 범위만 허용합니다.

로컬 설치

git clone https://github.com/isnow890/data4library-mcp.git
cd data4library-mcp
npm install
npm run build

MCP 클라이언트에서는 빌드 결과인 dist/src/index.js를 실행합니다.

{
  "mcpServers": {
    "data4library-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/data4library-mcp/dist/src/index.js"],
      "cwd": "/absolute/path/to/data4library-mcp",
      "env": {
        "LIBRARY_API_KEY": "your-api-key"
      }
    }
  }
}

로컬 실행

export LIBRARY_API_KEY="your-api-key"
npm run build
npm start

Docker로 실행할 수도 있습니다.

docker build -t data4library-mcp .
docker run -i --rm -e LIBRARY_API_KEY="$LIBRARY_API_KEY" data4library-mcp

사용 예시

“서울 강남구 공공도서관 찾아줘”
- search_detailed_region_codes로 지역 코드를 찾고 search_libraries를 호출합니다.
“이 ISBN을 소장한 서울 도서관 찾아줘”
- search_libraries_by_book을 호출합니다.
“이 도서관에 이 책이 있고 전일 기준으로 대출 가능했어?”
- check_book_availability을 호출합니다.
“요즘 20대가 많이 빌린 책 보여줘”
- search_popular_books를 연령 조건과 함께 호출합니다.

데이터와 제한사항

데이터 출처는 도서관 정보나루입니다.
소장·통계 데이터의 갱신 시점은 정보나루 원천을 따릅니다.
check_book_availability의 대출 가능 여부는 전일 기준이며 실시간 예약·대출 상태를 보장하지 않습니다.
search_nearby_libraries의 거리는 직선거리이며 실제 이동 거리와 다를 수 있습니다.

개발

npm run build
npm run watch

자동 회귀 테스트는 아직 구성되어 있지 않습니다.

라이선스

MIT

data4library mcp