M MCP모아
튜토리얼

도서관 정보나루 MCP 서버 설치·사용법 — 국립도서관 통합 API로 도서 검색·대출 현황

data4library-mcp를 Claude·Cursor에 연결해 국립도서관 통합 API로 도서 검색, 대출 현황, 인근 도서관 탐색을 AI로 즉시 처리하는 단계별 설치 가이드입니다.

도서관 정보나루 MCP 서버가 Claude와 연결되어 도서 검색 결과를 반환하는 흐름을 나타낸 표지 이미지

국립도서관 통합 API(도서관 정보나루)를 Claude·Cursor에 MCP로 연결하면, 채팅 한 줄로 전국 공공도서관의 도서 검색·대출 현황·인근 도서관 탐색이 가능합니다. data4library-mcp 서버를 npx 한 줄로 설치하고, API 키 하나만 설정하면 25개의 도구를 AI가 직접 호출합니다. 이 글에서는 API 키 발급부터 설정 파일 작성, 동작 확인, 흔한 오류 해결까지 순서대로 안내합니다.

왜 도서관 정보나루 MCP가 필요한가요?

도서관 정보나루(data4library.kr)는 국립중앙도서관이 운영하는 공공도서관 통합 데이터 플랫폼입니다. 전국 수천 개 도서관의 장서·대출·반납 정보를 REST API로 제공하지만, 매번 쿼리 파라미터를 조합해 직접 호출하기는 번거롭습니다.

MCP(Model Context Protocol)로 연결하면 상황이 달라집니다. “서울 강남구 근처에서 ‘파이썬 머신러닝’ 책을 대출 가능한 도서관 알려줘”처럼 자연어 한 문장으로 AI가 여러 API 호출을 조합해 결과를 가져옵니다. 개발자·연구자·독서 애호가 모두에게 즉각적인 생산성 향상이 됩니다.

사용자 (자연어)
    │
    ▼
Claude / Cursor (LLM)
    │  MCP 프로토콜 (JSON-RPC)
    ▼
data4library-mcp 서버 (npx)
    │  HTTP REST API (인증 키 포함)
    ▼
도서관 정보나루 (data4library.kr)
    │
    ▼
국립중앙도서관 / 전국 공공도서관 데이터

data4library-mcp 서버란?

data4library-mcp는 개발자 isnow890이 오픈소스로 공개한 MCP 서버입니다. 도서관 정보나루의 여러 엔드포인트를 25개의 MCP 도구(tool)로 감싸, Claude 같은 AI가 자연어 명령에 따라 적절한 API를 선택해 호출합니다.

주요 기능 25가지 도구 요약

도구 범주예시 기능
도서 검색키워드·ISBN·저자·출판사 기반 통합 검색
대출 현황특정 도서관의 특정 도서 대출 가능 여부 조회
인기 도서기간별·주제별 인기 대출 도서 목록
도서관 탐색지역·지번 기반 인근 도서관 목록 및 상세 정보
독서 통계연령별·지역별 독서 패턴 데이터

GitHub 저장소: https://github.com/isnow890/data4library-mcp

준비물 확인

시작 전에 다음 세 가지가 준비되어 있는지 확인하세요.

항목확인 방법비고
Node.js 18 이상node --versionnpx 포함
Claude Desktop 또는 Cursor앱 실행 확인MCP 지원 버전 필요
data4library.kr API 키아래 1단계 참고무료

단계별 설치 방법

1단계: API 키 발급

  1. https://www.data4library.kr/ 에 접속합니다.
  2. 우측 상단 회원가입 또는 로그인 후 마이페이지로 이동합니다.
  3. 인증키 신청 메뉴에서 API 키를 발급받습니다. 심사 없이 즉시 발급됩니다.
  4. 발급된 키를 안전한 곳에 복사해 두세요.

2단계: Node.js 및 npx 설치 확인

터미널(macOS: 터미널.app, Windows: PowerShell)에서 아래 명령을 실행하세요.

node --version
npx --version

v18.0.0 이상이 출력되면 준비 완료입니다. 설치되지 않았다면 https://nodejs.org/ 에서 LTS 버전을 설치하세요.

3단계: 설정 파일 열기

Claude Desktop 기준 설정 파일 위치는 다음과 같습니다.

운영체제경로
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

파일이 없다면 빈 파일을 새로 만드세요. JSON 형식이어야 합니다.

Cursor 사용자는 프로젝트 루트 또는 홈 디렉터리의 .cursor/mcp.json 파일을 사용합니다.

4단계: MCP 서버 항목 추가

설정 파일을 열고 아래 내용을 추가합니다. 기존에 다른 서버가 있다면 mcpServers 객체 안에 새 항목만 추가하세요.

{
  "mcpServers": {
    "data4library-mcp": {
      "command": "npx",
      "args": ["-y", "@isnow890/data4library-mcp"],
      "env": {
        "LIBDATA_API_KEY": "여기에_발급받은_API_키_입력"
      }
    }
  }
}

LIBDATA_API_KEY 값에 1단계에서 발급받은 키를 입력하세요. 큰따옴표 안에 키 값만 넣으면 됩니다.

5단계: Claude Desktop 재시작 후 동작 확인

파일을 저장하고 Claude Desktop을 완전히 종료 후 다시 실행합니다(트레이 아이콘도 확인). 재시작 후 채팅창에서 아래처럼 입력해 보세요.

국립중앙도서관에서 '파이썬 데이터 분석' 관련 도서를 검색해줘

Claude가 data4library-mcp 도구를 호출해 실제 검색 결과를 반환하면 연결에 성공한 것입니다.

활용 예시 — 실제 사용 방법

연결 후 아래와 같은 자연어 명령을 바로 사용할 수 있습니다.

# 도서 검색
ISBN 9791162242681 도서 정보 알려줘

# 대출 가능 여부
서울 마포구 도서관에서 '채식주의자' 대출 가능한 곳 있어?

# 인근 도서관 탐색
위도 37.5665, 경도 126.9780 근처 공공도서관 목록 보여줘

# 인기 도서
이번 달 20대가 가장 많이 빌린 책 5권은?

흔한 오류와 해결 방법

설치·연결 시 자주 발생하는 문제를 정리했습니다.

”도구가 표시되지 않아요”

Claude Desktop을 완전히 종료 후 재시작하세요. macOS에서는 메뉴 막대의 Claude 아이콘을 우클릭해 Quit을 선택해야 완전 종료됩니다. 단순히 창을 닫는 것만으로는 부족할 수 있습니다.

JSON 파싱 오류

설정 파일의 JSON 문법이 잘못되면 Claude가 MCP 서버를 로드하지 못합니다. 아래 항목을 점검하세요.

  • 중괄호({ }) 짝이 맞는지 확인
  • 마지막 항목 뒤 쉼표(trailing comma) 제거
  • 키·값은 모두 큰따옴표로 감싸기
  • JSONLint 같은 온라인 검사 도구 활용

”API 키가 유효하지 않다”는 오류

LIBDATA_API_KEY 값에 공백이나 줄바꿈이 포함되지 않았는지 확인하세요. data4library.kr 마이페이지에서 키를 다시 복사해 붙여넣으면 대부분 해결됩니다.

npx 실행 권한 오류 (macOS/Linux)

회사 네트워크나 보안 정책이 엄격한 환경에서는 npx가 패키지를 다운로드하지 못할 수 있습니다. 이 경우 패키지를 전역으로 미리 설치하는 방법을 사용할 수 있습니다.

npm install -g @isnow890/data4library-mcp

그 후 설정 파일의 command를 "npx" 대신 "data4library-mcp"로 변경하고 "args" 배열을 비워두세요.

자주 묻는 질문

data4library.kr API 키는 유료인가요?

아니요, 무료입니다. data4library.kr에 회원가입 후 마이페이지에서 바로 발급할 수 있으며, 별도 심사나 비용 없이 즉시 사용 가능합니다.

도서관 정보나루 MCP 서버가 제공하는 도구는 몇 개인가요?

현재 총 25개의 도구를 제공합니다. 도서 검색, 대출 현황, 인근 도서관 탐색, 인기 도서 통계 등이 포함됩니다. 전체 목록은 GitHub 저장소에서 확인하세요.

Cursor에서도 사용할 수 있나요?

네, 사용 가능합니다. Cursor의 MCP 설정 파일(.cursor/mcp.json)에 동일한 mcpServers 항목을 추가하면 됩니다. 설정 형식은 Claude Desktop과 거의 동일합니다.

전국 모든 공공도서관 데이터를 조회할 수 있나요?

도서관 정보나루 API는 국립중앙도서관이 운영하는 통합 플랫폼으로, 전국 공공도서관의 장서·대출 정보를 다수 포함합니다. 다만 일부 지역 도서관은 연동이 되지 않을 수 있으니 공식 문서를 참고하세요.

API 키를 환경 변수로 관리해야 하나요?

네, 강력히 권장합니다. 설정 파일에 키를 직접 입력하면 편리하지만, 파일이 외부에 노출되면 키가 유출될 수 있습니다. 운영 환경에서는 OS 수준 환경 변수나 비밀 관리 도구를 활용하세요.

연결 후 도구가 보이지 않으면 어떻게 하나요?

Claude Desktop을 완전히 종료 후 재시작하고, JSON 문법 오류가 없는지 설정 파일을 다시 확인하세요. 중괄호 짝·쉼표 위치를 점검하면 대부분 해결됩니다.

다음 단계 — 관련 한국 공공데이터 MCP 서버

도서관 데이터 외에도 한국 공공데이터를 AI로 활용하는 MCP 서버가 다양하게 있습니다.

더 많은 한국산 MCP 서버는 MCP모아 서버 목록에서 탐색할 수 있습니다. 직접 만든 MCP 서버가 있다면 등록 신청도 환영합니다.

이 글과 관련된 MCP 서버