MCP 활용방법 - 데이터 활용 - 도서관 정보나루

MCP(Model Context Protocol)는 AI 어시스턴트가 도서관 정보나루의 데이터를 직접 조회할 수 있도록 연결하는 표준 프로토콜입니다.
AI에게 자연어로 질문하면 아래 도구(Tool)들을 통해 도서관·도서·대출 데이터를 실시간으로 검색하여 답변합니다.

도구목록 (Tool)

각 도구의 제목을 클릭하면 주요기능, 활용예제, 파라미터를 확인할 수 있습니다. (총 16개)

도서관 검색 search_libraries

주요기능: 지역(시·도/시·군·구) 또는 도서관 코드로 데이터를 공개하는 도서관 목록을 조회합니다. 도서관 이름으로 찾으려면 도서관 코드 검색(search_library_codes)을 이용하세요.

활용예제: "서울특별시 서초구에 있는 도서관을 알려줘"

파라미터

파라미터	타입	필수	설명
`region`	string	△	시·도 코드 (2자리, 예: 11 = 서울)
`dtl_region`	string	△	시·군·구 코드 (5자리, 예: 11010 = 서울 종로구)
`lib_code`	string	△	도서관 코드 (특정 도서관 직접 조회 시)
`page`	integer	△	페이지 번호 (기본값: 1)
`pageSize`	integer	△	페이지당 결과 수 (기본값: 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

인기 대출 도서 조회 get_popular_loans

주요기능: 기간·연령·성별·지역·KDC 분류·이용대상 등 다양한 조건으로 인기 대출 도서 순위를 조회합니다.

활용예제: "2025년에 20대 여성이 많이 빌린 책 순위를 알려줘"

파라미터

파라미터	타입	필수	설명
`start_dt / end_dt`	string	△	대출 검색 시작일 / 종료일 (YYYY-MM-DD)
`age`	string	△	연령 (예: 20, ';'로 다중 지정 가능)
`from_age / to_age`	string	△	연령 구간 (age와 동시 사용 불가)
`gender`	string	△	0(남) / 1(여) / 2(미상)
`region / dtl_region`	string	△	시·도 / 시·군·구 코드
`kdc`	string	△	KDC 주제 분류 코드
`book_dvsn`	string	△	big(큰글씨) / oversea(국외도서)
`page / pageSize`	integer	△	페이지 번호 / 결과 수 (기본값: 1 / 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

추천 도서 조회 get_book_recommendations

주요기능: 특정 도서(ISBN)를 기반으로 추천 도서 목록을 조회합니다. 마니아 추천(mania) 또는 다독자 추천(reader)을 선택할 수 있으며, 한 번에 최대 200건을 반환합니다.

활용예제: "이 책을 좋아하는 사람에게 추천할 만한 책을 알려줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`type`	string	△	mania(마니아) / reader(다독자) (기본값: mania)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서 종합 프로필 get_book_full_profile

주요기능: 특정 도서(ISBN)의 상세 이용분석(대출 추이·연령/성별 분포), 키워드, 추천(마니아/다독자)을 한 번에 조회하여 종합 프로필을 제공합니다.

활용예제: "이 책에 대해 종합적으로 분석해줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`period`	integer	△	대출 추이 최근 N개월 (기본값: 6)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서 키워드 조회 get_book_keywords

주요기능: 특정 도서(ISBN)의 핵심 키워드(상위 50개)를 조회합니다. 부가정보 옵션으로 도서명·저자·출판사·출판연도 등을 함께 받을 수 있습니다.

활용예제: "이 책의 핵심 키워드를 알려줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`additional_info`	boolean	△	부가정보 포함 여부 (기본값: false)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서별 이용분석 get_book_analysis

주요기능: 특정 도서(ISBN)의 대출 추이, 연령별·성별 다대출 그룹, 함께 대출된 도서를 분석하여 제공합니다.

활용예제: "이 책은 주로 어떤 연령대가 많이 빌렸어?"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`type`	string	△	loan(대출 추이) / age(연령별) / gender(성별) / coLoan(함께 대출) (기본값: loan)
`period`	integer	△	type=loan일 때 최근 N개월 (최대 12, 기본값: 6)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서 대출 가능 여부 확인 check_book_availability

주요기능: 특정 도서관(lib_code)에서 특정 도서(ISBN)의 소장 및 현재 대출 가능 여부를 확인합니다. 소장 데이터는 월 단위로 갱신되어 실시간 재고와 시차가 있을 수 있습니다.

활용예제: "이 책이 강남도서관에서 지금 대출 가능한지 확인해줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`lib_code`	string	○	도서관 코드
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

주변 소장 도서관 · 대출 가능 여부 find_book_nearby

주요기능: 특정 도서(ISBN)의 소장 도서관 목록과 각 도서관의 현재 대출 가능 여부를 한 번에 조회합니다. (도서관 조회 + 대출 가능 여부를 통합 실행)

활용예제: "서울에서 이 책을 지금 빌릴 수 있는 도서관을 찾아줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`region`	string	○	시·도 코드 (2자리)
`dtl_region`	string	△	시·군·구 코드 (5자리)
`page / pageSize`	integer	△	페이지 번호 / 결과 수 (기본값: 1 / 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서 소장 도서관 조회 get_library_collection

주요기능: 특정 도서(ISBN)를 소장하고 있는 도서관 목록을 시·도(region)별로 조회합니다. 결과는 입력한 ISBN 한 판본 기준이므로, 다른 판본의 소장처는 해당 ISBN으로 다시 조회해야 합니다.

활용예제: "ISBN 9788983921987 도서를 서울에서 소장한 도서관을 찾아줘"

파라미터

파라미터	타입	필수	설명
`isbn13`	string	○	13자리 ISBN
`region`	string	○	시·도 코드 (2자리)
`dtl_region`	string	△	시·군·구 코드 (5자리)
`page`	integer	△	페이지 번호 (기본값: 1)
`pageSize`	integer	△	페이지당 결과 수 (기본값: 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서 검색 search_books

주요기능: 도서명·저자·키워드·출판사·ISBN으로 도서를 검색합니다. 최소 한 가지 검색 조건이 필요합니다.

활용예제: "한강 작가의 채식주의자 책을 검색해줘"

파라미터

파라미터	타입	필수	설명
`title`	string	△	도서명
`author`	string	△	저자명
`keyword`	string	△	검색 키워드
`publisher`	string	△	출판사
`isbn13`	string	△	13자리 ISBN
`exact_match`	boolean	△	정확 일치 여부 (기본값: false)
`sort`	string	△	정렬 기준 title/author/isbn/pub/pubYear/loan (기본값: loan)
`order`	string	△	정렬 순서 asc/desc (기본값: desc)
`page / pageSize`	integer	△	페이지 번호 / 결과 수 (기본값: 1 / 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

※ title, author, keyword, publisher, isbn13 중 최소 한 가지는 반드시 입력해야 합니다.

도서별 대출 통계 조회 get_book_usage

주요기능: 키워드로 도서 목록과 도서별 대출 통계(대출횟수)를 함께 조회합니다. 출판연도 범위로 결과를 좁힐 수 있습니다.

활용예제: "인공지능 관련 도서의 대출 통계를 보여줘"

파라미터

파라미터	타입	필수	설명
`keyword`	string	△	검색 키워드
`publish_year_start`	string	△	출판연도 시작 (YYYY)
`publish_year_end`	string	△	출판연도 종료 (YYYY)
`page / pageSize`	integer	△	페이지 번호 / 결과 수 (기본값: 1 / 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

이달의 트렌드 키워드 get_monthly_keywords

주요기능: 지정한 월의 대출급상승 도서에서 추출된 트렌드 키워드(상위 100개)를 조회합니다.

활용예제: "2026년 4월의 도서 트렌드 키워드를 보여줘"

파라미터

파라미터	타입	필수	설명
`month`	string	○	조회 월 (YYYY-MM, 예: 2026-04)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

지역별 독서량/독서율 get_reading_statistics

주요기능: 지역·연령별 독서량 및 독서율 통계를 조회합니다.

활용예제: "2025년 서울 지역의 독서율 통계를 알려줘"

파라미터

파라미터	타입	필수	설명
`year`	string	○	조회 연도 (YYYY)
`region / dtl_region`	string	△	시·도 / 시·군·구 코드
`month`	string	△	조회 월 (MM, 2자리)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

신착 도서 조회 get_new_arrivals

주요기능: 특정 도서관의 월별 신착 도서 목록을 조회합니다.

활용예제: "서초구립반포도서관 이번 달 신착 도서 알려줘"

파라미터

파라미터	타입	필수	설명
`lib_code`	string	○	도서관 코드
`search_dt`	string	△	조회 월 (YYYY-MM, 생략 시 당월)
`page`	integer	△	페이지 번호 (기본값: 1)
`pageSize`	integer	△	페이지당 결과 수 (기본값: 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

도서관 코드 검색 search_library_codes

주요기능: 도서관명으로 도서관 코드(lib_code)를 검색합니다. 다른 도구의 lib_code 파라미터에 사용할 코드를 찾을 때 활용하세요. (부분 일치 검색)

활용예제: "국립중앙도서관의 도서관 코드를 찾아줘"

파라미터

파라미터	타입	필수	설명
`lib_name`	string	○	도서관명 (부분 일치)
`page`	integer	△	페이지 번호 (기본값: 1)
`pageSize`	integer	△	페이지당 결과 수 (기본값: 10)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

지역 코드 검색 search_region_codes

주요기능: 지역명으로 광역시·도 및 시·군·구 지역 코드를 검색합니다. 다른 도구의 region/dtl_region 파라미터에 사용할 코드를 찾을 때 활용하세요. (부분 일치 검색)

활용예제: "성남시 지역 코드를 알려줘"

파라미터

파라미터	타입	필수	설명
`region_name`	string	○	지역명 (부분 일치)
`auth_key`	string	△	클라이언트 자동 주입 — 호출 시 생략 가능

이용절차

이용신청

STEP.01

회원가입

MCP를 활용하려면 회원가입을 하셔야합니다.

STEP.02

인증키 신청

사용자에게 인증키가 있어야 MCP를 이용할 수 있습니다.

STEP.03

인증키 발급

인증키는 발급 신청 후, 사용 가능합니다.

STEP.04

MCP 활용

MCP 매뉴얼을 참고해 주세요.