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

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

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

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

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

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

도서관 정보나루 API를 Claude MCP로 직접 연결하기 (직접 빌드 가이드)

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

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

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

한도 초과 시 API에서 오류 응답이 반환됩니다. 도서관 정보나루 공식 사이트에서 호출 한도와 증량 신청 방법을 확인하실 수 있습니다.

“이 책 어느 도서관에 있어?”, “지금 대출 가능한 곳은?” 같은 질문을 Claude에게 자연어로 던지고 바로 답을 받고 싶다면, 도서관 정보나루(data4library.kr)의 오픈 API를 MCP로 연결하면 됩니다. 다만 2026년 6월 현재 도서관 정보나루를 전용으로 래핑한 공개 MCP 패키지는 아직 없습니다. 그래서 이 글은 “설치만 하면 끝”인 가이드가 아니라, 전용 서버가 없는 공공 API를 Claude에 붙이는 두 가지 실전 경로를 정리한 직접 연결 가이드입니다.

도서관 정보나루는 문화체육관광부 산하 국립중앙도서관이 운영하는 공공 데이터 허브로, 전국 1,200여 개 공공도서관의 소장 자료, 대출 통계, 신간 알림 등을 REST API로 공개합니다. API 자체는 안정적으로 제공되므로, MCP 래퍼만 갖추면 AI가 전국 소장 현황을 한 번의 대화로 모아 답해 줄 수 있습니다.

이 가이드가 풀어주는 문제

전용 MCP가 없다는 사실은 막다른 길이 아니라 선택지가 두 개라는 뜻입니다.

경로	누구에게 적합한가	들이는 노력
경로 A — 기존 공공데이터 래퍼 활용	코드를 거의 안 쓰고, data.go.kr 계열 도서관 데이터로 충분한 경우	낮음 (설정만)
경로 B — 직접 래퍼 빌드	도서관 정보나루 고유 엔드포인트(소장·대출·인기도서)를 그대로 쓰고 싶은 경우	중간 (Python 작성)

도서관 정보나루의 소장 검색·실시간 대출 가능 여부·인기 대출 도서 같은 기능을 온전히 쓰려면 경로 B(직접 빌드) 가 정공법입니다. 경로 A는 빠른 시작용 우회로로 보면 됩니다.

[데이터 흐름]

사용자 질문
    │
    ▼
Claude Desktop (Claude AI)
    │  MCP 프로토콜(stdio)
    ▼
도서관 정보나루 MCP 래퍼 (직접 빌드 또는 우회)
    │  HTTPS API 호출
    ▼
도서관 정보나루 API (data4library.kr)
    │  JSON 응답
    ▼
Claude Desktop → 사용자에게 정리된 답변

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

준비물

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

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

어느 경로를 택하든 인증 키 발급이 먼저입니다.

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

도서관 정보나루 오픈 API는 무료이며, 일일 호출 한도 내에서 자유롭게 사용할 수 있습니다.

2단계 — 연결 경로 선택

경로 A — 공공데이터포털 MCP 서버 모음으로 빠르게 시작

코드 작성 없이 data.go.kr 계열 도서관 데이터부터 써 보고 싶다면 공공데이터포털 MCP 서버 모음(data-go-mcp-servers)을 활용합니다. data.go.kr 계열 API를 MCP로 묶어 둔 서버로, 저장소에 도서관 관련 서버가 포함됐는지 먼저 확인하세요.

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

이 모음은 data.go.kr 키 기반으로 동작하므로, 도서관 정보나루 고유 엔드포인트(실시간 대출 가능 여부 등)는 다루지 못할 수 있습니다. 도서관 정보나루의 전체 기능이 필요하면 경로 B로 넘어가세요.

경로 B — 도서관 정보나루 전용 래퍼 직접 빌드

도서관 정보나루 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"
# 인증 키는 환경 변수에서 읽어 코드에 하드코딩하지 않습니다

주의: 위 코드는 구조 안내용 뼈대입니다. 실제 도구 핸들러 구현과 stdio 서버 기동 방식은 MCP Python SDK 공식 문서를 참고하세요. 호출할 엔드포인트와 파라미터는 data4library.kr 오픈 API 문서에 정리돼 있습니다.

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 등록 (직접 빌드한 도서관 래퍼, Python 방식):

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

args의 경로는 반드시 절대 경로로 적고, 저장할 때 쉼표·따옴표·중괄호 오류가 없는지 확인하세요. JSON 문법 오류가 하나라도 있으면 Claude Desktop이 서버를 인식하지 못합니다.

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

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

재시작 후 새 대화 창을 열면 도구 패널에 연결된 MCP 서버 목록이 표시됩니다. 서버 이름 옆에 초록색 점(활성) 표시가 보이면 정상 연결된 것입니다. Claude Code를 사용한다면 터미널에서 /mcp 명령으로 연결 상태를 확인할 수 있습니다.

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

연결이 완료되면 자연어로 바로 질문할 수 있습니다.

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

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

답변이 비어 있거나 “도구를 찾을 수 없다”고 나오면, 경로 A에서는 해당 데이터가 모음에 포함되지 않았을 가능성이, 경로 B에서는 도구 핸들러가 아직 구현되지 않았을 가능성이 큽니다.

흔한 오류와 해결 방법

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

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

직접 래퍼를 빌드할 때 도구로 노출할 만한 핵심 기능입니다.

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

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

자주 묻는 질문

도서관 정보나루 전용 MCP 서버가 정말 없나요?

2026년 6월 현재 도서관 정보나루를 전용으로 래핑한 공개 MCP 패키지는 확인되지 않습니다. 그래서 이 글은 경로 A(기존 공공데이터 래퍼)와 경로 B(직접 빌드)를 안내합니다. 전용 서버가 새로 등장하면 MCP모아 서버 등록으로 공유해 주세요.

그럼 코드를 모르면 못 쓰나요?

경로 A는 코드 작성 없이 설정만으로 시작할 수 있습니다. 다만 도서관 정보나루의 실시간 대출 가능 여부 같은 고유 기능까지 쓰려면 경로 B의 직접 빌드가 필요합니다.

도서관 정보나루 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 문법 오류 여부를 점검하세요.

다음 단계

도서관 정보나루를 연결했다면 다른 한국 공공데이터도 같은 방식으로 AI에 붙여 보세요. 공공데이터포털 MCP 서버 모음으로 국민연금·조달청 데이터를, 한국 부동산 MCP로 실거래가 분석을 대화로 처리할 수 있습니다.

도서관 정보나루 전용 래퍼를 직접 만드셨다면 MCP모아 서버 등록 페이지에 공유해 주세요. 다른 사람의 직접 빌드 수고를 덜어 줄 수 있습니다. 전체 MCP 서버 목록도 함께 둘러보세요.