도서관 공공데이터 MCP — 도서관 정보나루 API를 Claude에 연결하기

Q: 도서관 정보나루 외에 비슷한 한국 공공데이터 MCP 서버가 있나요?

네, 공공데이터포털(data.go.kr) API를 연결하는 data-go-mcp-servers나 국토교통부 실거래가를 연결하는 한국 부동산 MCP 등 다양한 한국형 MCP 서버가 있습니다. /category/public-data에서 목록을 확인해 보세요.

도서관 공공데이터 MCP 서버를 Claude에 연결하면 “이 책 어느 도서관에 있어?”, “대출 가능한 곳 알려줘” 같은 질문을 자연어로 바로 해결할 수 있습니다. 국가도서관통계시스템이 운영하는 **도서관 정보나루(data4library.kr)**의 오픈 API를 MCP로 연결하면, AI가 전국 공공도서관 소장 정보와 대출 현황을 실시간으로 조회해 돌려줍니다. 이 가이드는 API 키 발급부터 Claude Desktop 연결, 실전 활용 예시까지 한 번에 안내합니다.

왜 도서관 공공데이터를 MCP로 연결해야 할까

도서관 정보나루는 문화체육관광부 산하 국립중앙도서관이 운영하는 공공 데이터 허브로, 전국 1,200여 개 공공도서관의 소장 자료, 대출 통계, 신간 알림 등을 API로 공개합니다. 기존에는 직접 웹사이트에 들어가 도서관마다 검색해야 했지만, MCP 서버를 통해 AI와 연동하면 대화 한 번으로 전국 소장 현황을 한꺼번에 파악할 수 있습니다.

특히 독서 모임 운영자, 사서, 연구자, 학부모 등 도서 자료를 자주 찾는 분들에게 큰 도움이 됩니다. “파친코 소장한 서울 도서관 3곳과 대출 가능 여부” 같은 복합 질의도 Claude가 MCP 도구를 자동 호출해 처리해 줍니다.

[데이터 흐름]

사용자 질문
    │
    ▼
Claude Desktop (Claude AI)
    │  MCP 프로토콜(stdio)
    ▼
도서관 정보나루 MCP 서버
    │  HTTPS API 호출
    ▼
도서관 정보나루 API (data4library.kr)
    │  JSON 응답
    ▼
Claude Desktop → 사용자에게 정리된 답변

준비물

항목	설명
도서관 정보나루 계정	data4library.kr 무료 회원가입
오픈 API 인증 키	가입 후 신청, 무료 발급
Claude Desktop	claude.ai/download에서 설치
Git	서버 소스 클론용
Python 3.10 이상	MCP 서버 실행 환경

단계별 설치 방법

1단계 — 도서관 정보나루 API 키 발급

data4library.kr에 접속해 회원가입을 합니다.
로그인 후 상단 메뉴 오픈 API → 인증키 신청으로 이동합니다.
활용 목적을 간단히 입력하고 신청하면 이메일로 인증 키가 발송됩니다.
발급된 키를 안전한 곳에 보관합니다. 이 키는 외부에 노출되면 안 됩니다.

발급된 키는 영문·숫자 혼합 문자열입니다. 도서관 정보나루 오픈 API는 무료이며 일일 호출 한도 내에서 자유롭게 사용할 수 있습니다.

2단계 — MCP 서버 저장소 클론 및 환경 설정

현재 도서관 정보나루를 전용으로 래핑한 단일 MCP 패키지는 공개된 것이 없습니다. 대신 아래 두 가지 방법을 사용할 수 있습니다.

방법 A: 공공데이터포털 MCP 서버 모음 활용

공공데이터포털 MCP 서버 모음(data-go-mcp-servers)은 data.go.kr 계열 API를 MCP로 묶어 놓은 서버입니다. GitHub 저장소를 직접 확인해 도서관 데이터 관련 서버가 추가됐는지 살펴보세요.

# 저장소 확인
git clone https://github.com/Koomook/data-go-mcp-servers
cd data-go-mcp-servers
ls

방법 B: 범용 HTTP MCP 래퍼 직접 구성

도서관 정보나루 API는 REST 방식이므로, MCP Python SDK를 사용해 직접 래퍼 서버를 만들 수 있습니다. 아래는 최소 구성 예시입니다.

# 의존성 설치
pip install mcp httpx

# 서버 파일 생성 후 실행
python library_mcp_server.py

서버 파이썬 파일의 핵심 구조는 다음과 같습니다.

# library_mcp_server.py 핵심 구조 예시
# (실제 코드는 mcp 패키지 공식 문서를 참고해 작성하세요)

import httpx
from mcp.server import Server
from mcp.server.stdio import stdio_server

API_BASE = "https://data4library.kr/api"
# 환경 변수에서 인증 키를 읽어야 합니다

주의: 위 코드는 구조 안내용 예시입니다. 실제 도구 핸들러 구현은 MCP Python SDK 공식 문서를 참고하세요.

3단계 — Claude Desktop 설정 파일에 서버 등록

Claude Desktop의 설정 파일 위치는 운영체제에 따라 다릅니다.

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

설정 파일을 열고 아래 블록을 mcpServers 항목에 추가합니다.

방법 A(data-go-mcp-servers uvx 방식):

{
  "mcpServers": {
    "data-go-mcp": {
      "command": "uvx",
      "args": ["data-go-mcp.nps-business-enrollment@latest"],
      "env": {
        "DATA_GO_KR_API_KEY": "발급받은_공공데이터포털_키"
      }
    }
  }
}

방법 B(직접 구성한 도서관 MCP 서버 Python 방식):

{
  "mcpServers": {
    "library-mcp": {
      "command": "python",
      "args": ["/절대경로/library_mcp_server.py"],
      "env": {
        "LIBRARY_API_KEY": "발급받은_도서관정보나루_키"
      }
    }
  }
}

JSON 파일을 저장할 때 쉼표, 따옴표, 중괄호 오류가 없는지 꼭 확인하세요. JSON 문법 오류가 있으면 Claude Desktop이 MCP 서버를 인식하지 못합니다.

4단계 — Claude Desktop 재시작 및 연결 확인

설정 파일을 저장한 뒤 Claude Desktop을 완전히 종료하고 다시 시작합니다. 프로세스가 백그라운드에 남아 있으면 변경 사항이 적용되지 않을 수 있습니다.

재시작 후 새 대화 창을 열면 왼쪽 하단(또는 도구 패널)에 연결된 MCP 서버 목록이 표시됩니다. 서버 이름 옆에 초록색 점(활성) 표시가 보이면 정상 연결된 것입니다.

Claude Code를 사용하신다면 터미널에서 /mcp 명령을 실행하면 연결 상태를 확인할 수 있습니다.

5단계 — 도서 검색 및 대출 현황 조회

연결이 완료되면 Claude에서 자연어로 도서관 관련 질문을 바로 할 수 있습니다.

활용 예시 프롬프트:

"채식주의자(한강) 소장한 서울 도서관 목록 알려줘"
"근처 도서관에서 대출 가능한 파이썬 입문서 추천해줘"
"올해 1월 전국 공공도서관 대출 건수 상위 10권 알려줘"
"우리 동네 구립 도서관에서 이 책 예약 가능한지 확인해줘"

Claude가 MCP 도구를 자동 호출해 도서관 정보나루 API에서 데이터를 가져와 정리된 형태로 답변해 줍니다.

흔한 오류와 해결 방법

오류 증상	원인	해결 방법
MCP 서버가 목록에 나타나지 않음	JSON 문법 오류 또는 경로 오류	설정 파일을 JSON 검증기로 확인 후 재시작
API 호출 오류(401/403)	API 키 미입력 또는 오류	env 항목의 키 값과 환경 변수명 재확인
응답이 느리거나 타임아웃	네트워크 또는 API 서버 이슈	도서관 정보나루 서비스 상태 확인 후 재시도
`uvx` 명령을 찾을 수 없음	uv 미설치	`pip install uv` 또는 공식 문서 참고 설치
Python 모듈 오류	의존성 미설치	`pip install mcp httpx` 재실행

도서관 정보나루 주요 API 기능

도서관 정보나루 오픈 API가 제공하는 주요 기능은 다음과 같습니다.

API 기능	설명
도서관 정보 조회	전국 도서관 목록, 위치, 운영 시간
소장 자료 검색	ISBN·제목·저자로 소장 도서관 검색
대출 가능 여부 확인	실시간 대출 가능 권수 조회
인기 대출 도서	기간별·지역별 인기 도서 통계
신착 자료 알림	최근 입수된 신착 도서 목록
도서 추천	이용자 행태 기반 추천 도서

전체 API 엔드포인트와 요청 파라미터 상세 내용은 data4library.kr 오픈 API 문서에서 확인하세요.

자주 묻는 질문

도서관 정보나루 API 키는 유료인가요?

아니요, 도서관 정보나루(data4library.kr) 오픈 API는 무료로 제공됩니다. 회원가입 후 신청하면 즉시 발급되며, 일정 호출 횟수 한도 내에서 자유롭게 사용할 수 있습니다.

어떤 AI 클라이언트에서 사용할 수 있나요?

MCP 프로토콜을 지원하는 Claude Desktop, Claude Code, Cursor 등에서 모두 사용할 수 있습니다. 설정 파일 위치만 클라이언트마다 다릅니다. Claude Desktop은 claude_desktop_config.json, Cursor는 ~/.cursor/mcp.json을 사용합니다.

전국 모든 도서관 정보를 검색할 수 있나요?

도서관 정보나루는 전국 공공도서관의 소장 자료, 대출 가능 여부 등을 제공합니다. 다만 일부 특수도서관·사립도서관은 서비스에 포함되지 않을 수 있으니 공식 문서에서 지원 도서관 목록을 확인하세요.

API 호출 한도를 초과하면 어떻게 되나요?

한도 초과 시 API에서 오류 응답이 반환됩니다. 도서관 정보나루 공식 사이트에서 호출 한도와 증량 신청 방법을 확인하실 수 있습니다. 일반 개인 개발 용도라면 기본 한도로 충분한 경우가 많습니다.

MCP 서버 실행 중 연결 오류가 발생합니다. 어떻게 해결하나요?

API 키가 올바르게 입력됐는지, 환경 변수명이 서버가 요구하는 이름과 일치하는지 확인하세요. 또한 Claude Desktop을 완전히 종료한 뒤 다시 시작하고, 설정 파일의 JSON 문법 오류 여부도 점검하세요.

도서관 정보나루 외에 비슷한 한국 공공데이터 MCP 서버가 있나요?

네, 공공데이터포털 MCP 서버 모음이나 한국 부동산 MCP 등 다양한 한국형 MCP 서버가 있습니다. 공공데이터 카테고리에서 전체 목록을 확인해 보세요.

다음 단계

도서관 정보나루 MCP 서버를 연결했다면, 이제 더 많은 한국 공공데이터를 AI와 연결해 보세요. 공공데이터포털 MCP 서버 모음으로 국민연금·조달청 데이터를, 한국 부동산 MCP로 실거래가 분석을 AI 대화로 바로 해결할 수 있습니다.

새로운 한국형 MCP 서버를 발견하셨거나 직접 만드셨다면 MCP모아 서버 등록 페이지에서 공유해 주세요. 전체 MCP 서버 목록도 함께 둘러보시면 유용한 서버를 더 많이 찾으실 수 있습니다.