AI 에이전트가 IMLS 설문 조사 기반의 미국 공공 도서관 위치, 분관 상세 정보 및 소장 자료 데이터에 접근할 수 있도록 지원합니다.
다른 이름 library-api/libraryapi-mcp, libraryapi-mcp
- 스타
- 0
- Tools
- 6
- 다운로드, 30일
- 133
- 최신 버전
- 0.1.3
- 마지막 커밋
- 2026년 10월 4일
- 라이선스
- —
LibraryAPI MCP란?
LibraryAPI은(는) MCP server입니다. AI 에이전트가 IMLS 설문 조사 기반의 미국 공공 도서관 위치, 분관 상세 정보 및 소장 자료 데이터에 접근할 수 있도록 지원합니다. 6개 도구를 제공합니다. 예: find_libraries_near_address, find_libraries_near_coordinates, get_outlet.
프로젝트 README에서 생성된 요약
LibraryAPI MCP server 정보
LibraryAPI는 연방 IMLS 공공 도서관 설문 조사(Public Libraries Survey)에서 추출한 미국 공공 도서관 데이터를 AI 어시스턴트에 제공합니다. 개발자는 이 MCP server를 Claude Desktop 또는 Cursor와 같은 MCP 호환 클라이언트에 통합하여 위치 기반 검색 및 행정 데이터 조회를 구현할 수 있습니다. 이 서버는 에이전트가 전체 도서관 시스템과 개별 분관을 구분하여 처리할 수 있도록 특정 도구를 노출하는 방식으로 작동합니다.
사용자는 pip를 통해 서버를 설치하거나 uvx를 사용하여 직접 실행할 수 있습니다. 사용을 위해서는 libraryapi.dev에서 발급받은 LIBRARYAPI_KEY가 필요하며, 월 500회 요청까지 가능한 무료 티어를 제공합니다. 사용 가능한 도구 세트에는 근접 검색을 위한 find_libraries_near_address, 이름이나 도시로 시스템을 찾는 search_libraries, 주 단위 통계를 위한 get_state_summary가 포함됩니다. 데이터에 연간 및 주간 총 운영 시간은 포함되어 있으나, 분관별 상세 일일 운영 시간은 제공되지 않습니다.
활용 사례
- 1주변 도서관 분관 위치 찾기특정 도로 주소나 좌표를 기준으로 가장 가까운 공공 도서관 위치를 찾습니다.
- 2주 단위 도서관 통계 분석특정 주 내의 모든 공공 도서관에 대한 총 개수와 소장 자료 규모를 조회합니다.
- 3상세 분관 정보 조회고유 ID를 사용하여 특정 도서관 분관의 전체 기록을 가져옵니다.
- 4도서관 시스템 검색이름, 도시 또는 주 검색을 통해 행정 도서관 엔티티를 식별합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
LibraryAPI MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 LibraryAPI MCP 설치
$ claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcpCursor에 LibraryAPI MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}VS Code에 LibraryAPI MCP 설치
.vscode/mcp.json
{
"servers": {
"libraryapi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}VS Code CLI에 LibraryAPI MCP 설치
$ code --add-mcp '{"name":"libraryapi-mcp","type":"stdio","command":"uvx","args":["libraryapi-mcp"],"env":{"LIBRARYAPI_KEY":"<YOUR_LIBRARYAPI_KEY>"}}'Claude Desktop에 LibraryAPI MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Codex에 LibraryAPI MCP 설치
$ codex mcp add libraryapi-mcp --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' -- uvx libraryapi-mcpCodex config.toml에 LibraryAPI MCP 설치
~/.codex/config.toml
[mcp_servers.libraryapi-mcp] command = "uvx" args = ["libraryapi-mcp"] [mcp_servers.libraryapi-mcp.env] LIBRARYAPI_KEY = "<YOUR_LIBRARYAPI_KEY>"
Gemini CLI에 LibraryAPI MCP 설치
$ gemini mcp add -s user -e 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp uvx -- libraryapi-mcpGemini settings.json에 LibraryAPI MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}LibraryAPI MCP 도구 6
README에서 감지됨find_libraries_near_addressfind_libraries_near_coordinatesget_outletsearch_librariesget_libraryget_state_summary
| find_libraries_near_address | — | |
| find_libraries_near_coordinates | — | |
| get_outlet | — | |
| search_libraries | — | |
| get_library | — | |
| get_state_summary | — |
구성
LIBRARYAPI_KEY필수비밀API key from https://libraryapi.dev (free tier: 500 requests/month)
| 이름 | 설명 | 유형 |
|---|---|---|
| LIBRARYAPI_KEY | API key from https://libraryapi.dev (free tier: 500 requests/month) | 필수비밀 |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능library-api/libraryapi-mcp is public and reachablegithub.com/library-api/libraryapi-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시libraryapi-mcp names library-api/libraryapi-mcp as sourcepypi.org/project/libraryapi-mcp/ ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-04github.com/library-api/libraryapi-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from libraryapi-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음30 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음6 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기libraryapi-mcp
mcp-name: dev.libraryapi/libraryapi-mcp
MCP server for libraryapi.dev — US public library data for AI agents.
Expose library lookups as tools to any MCP-compatible AI assistant (Claude, Cursor, Copilot, etc.). Built on the federal IMLS Public Libraries Survey — public domain, commercially usable.
Installation
pip install libraryapi-mcp
Or run directly with uvx (no install needed):
uvx libraryapi-mcp
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"libraryapi": {
"command": "uvx",
"args": ["libraryapi-mcp"],
"env": {
"LIBRARYAPI_KEY": "your_api_key_here"
}
}
}
}
Cursor / other MCP clients
{
"mcpServers": {
"libraryapi": {
"command": "uvx",
"args": ["libraryapi-mcp"],
"env": {
"LIBRARYAPI_KEY": "your_api_key_here"
}
}
}
}
Get a free API key at libraryapi.dev — 500 requests/month, no credit card.
Available Tools
| Tool | Description |
|---|---|
find_libraries_near_address |
Find the nearest branches to a US street address |
find_libraries_near_coordinates |
Same, but from a lat/lng (skips geocoding) |
get_outlet |
Full record for one branch outlet by ID |
search_libraries |
Search library systems by name, state, or city |
get_library |
Full system profile by FSCS ID |
get_state_summary |
Statewide library totals |
Systems vs. outlets: a system is the administrative entity (e.g. "Chicago Public Library"); an outlet is an individual branch. Proximity searches return outlets.
Examples
Once configured, you can ask your AI assistant:
"What are the three closest public libraries to 350 Fifth Ave, New York?"
"How many public library branches are there in Vermont, and what's the total collection size?"
"I'm building a civic app — give me every library branch within 5 miles of downtown Chicago as JSON."
Data note
The IMLS survey covers locations, collections, staffing, visits, programs, and finances. It reports hours-open totals (annual, and per week) but not daily opening times — so this API can tell you a branch is open ~45 hours/week, not that it opens at 9am.
Links
- Website: libraryapi.dev
- PyPI: pypi.org/project/libraryapi-mcp
- REST API docs: libraryapi.dev/docs
License
MIT
LibraryAPI MCP 질문
LibraryAPI MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
LibraryAPI MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
LibraryAPI MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: find_libraries_near_address, find_libraries_near_coordinates, get_outlet, search_libraries, get_library.
어떤 종류의 도서관 데이터를 사용할 수 있나요?
IMLS 설문 조사를 바탕으로 한 도서관 위치, 소장 자료, 인력, 방문객 수, 프로그램 및 재무 데이터를 포함합니다.
특정 분관의 일일 운영 시간을 확인할 수 있나요?
아니요, API는 연간 또는 주간 총 운영 시간은 제공하지만 특정 일자의 상세 운영 시간은 포함하지 않습니다.