Memberikan akses ke lokasi perpustakaan umum di AS, detail cabang, dan data koleksi dari survei IMLS untuk AI agent.
Juga dikenal sebagai library-api/libraryapi-mcp, libraryapi-mcp
- Stars
- 0
- Tools
- 6
- Unduhan, 30 hari
- 133
- Versi terbaru
- 0.1.3
- Commit terakhir
- 4 Okt 2026
- Lisensi
- —
Apa itu LibraryAPI MCP?
LibraryAPI adalah MCP server. Memberikan akses ke lokasi perpustakaan umum di AS, detail cabang, dan data koleksi dari survei IMLS untuk AI agent. Server ini menyediakan 6 tool, seperti find_libraries_near_address, find_libraries_near_coordinates, get_outlet.
Ringkasan dibuat dari README proyek
Tentang LibraryAPI MCP server
LibraryAPI memberikan akses bagi asisten AI ke data perpustakaan umum Amerika Serikat yang bersumber dari IMLS Public Libraries Survey federal. Developer dapat mengintegrasikan MCP server ini ke dalam client yang kompatibel dengan MCP seperti Claude Desktop atau Cursor untuk mengaktifkan pencarian berbasis lokasi dan pengambilan data administratif. Server ini berfungsi dengan menyediakan tool spesifik yang memungkinkan agent untuk membedakan antara sistem perpustakaan secara keseluruhan dan outlet cabang individu.
User dapat menginstall server ini via pip atau menjalankannya secara langsung menggunakan uvx. Akses memerlukan LIBRARYAPI_KEY yang didapatkan dari libraryapi.dev, yang menawarkan tier gratis dengan batasan 500 request per bulan. Toolset yang tersedia mencakup find_libraries_near_address untuk pencarian jarak terdekat, search_libraries untuk mencari sistem berdasarkan nama atau kota, dan get_state_summary untuk statistik tingkat negara bagian. Meskipun data mencakup total jam buka tahunan dan mingguan, data ini tidak menyediakan jam buka harian yang spesifik untuk setiap cabang.
Apa yang bisa Anda lakukan dengannya
- 1Lokasi cabang perpustakaan terdekatTemukan lokasi perpustakaan umum terdekat dari alamat jalan atau koordinat tertentu.
- 2Analisis statistik perpustakaan tingkat negara bagianAmbil total jumlah dan ukuran koleksi untuk semua perpustakaan umum di dalam negara bagian tertentu.
- 3Ambil informasi detail cabangDapatkan catatan lengkap untuk outlet perpustakaan tertentu menggunakan ID uniknya.
- 4Cari sistem perpustakaanIdentifikasi entitas administratif perpustakaan dengan mencari nama, kota, atau negara bagian mereka.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal LibraryAPI MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal LibraryAPI MCP di Claude Code
$ claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcpInstal LibraryAPI MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instal LibraryAPI MCP di VS Code
.vscode/mcp.json
{
"servers": {
"libraryapi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instal LibraryAPI MCP di VS Code CLI
$ code --add-mcp '{"name":"libraryapi-mcp","type":"stdio","command":"uvx","args":["libraryapi-mcp"],"env":{"LIBRARYAPI_KEY":"<YOUR_LIBRARYAPI_KEY>"}}'Instal LibraryAPI MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instal LibraryAPI MCP di Codex
$ codex mcp add libraryapi-mcp --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' -- uvx libraryapi-mcpInstal LibraryAPI MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.libraryapi-mcp] command = "uvx" args = ["libraryapi-mcp"] [mcp_servers.libraryapi-mcp.env] LIBRARYAPI_KEY = "<YOUR_LIBRARYAPI_KEY>"
Instal LibraryAPI MCP di Gemini CLI
$ gemini mcp add -s user -e 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp uvx -- libraryapi-mcpInstal LibraryAPI MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Tool LibraryAPI MCP 6
Terdeteksi dari READMEfind_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 | — |
Konfigurasi
LIBRARYAPI_KEYWajibRahasiaAPI key from https://libraryapi.dev (free tier: 500 requests/month)
| Nama | Deskripsi | Tipe |
|---|---|---|
| LIBRARYAPI_KEY | API key from https://libraryapi.dev (free tier: 500 requests/month) | WajibRahasia |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaulibrary-api/libraryapi-mcp is public and reachablegithub.com/library-api/libraryapi-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyalibraryapi-mcp names library-api/libraryapi-mcp as sourcepypi.org/project/libraryapi-mcp/ ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-04github.com/library-api/libraryapi-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from libraryapi-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya30 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHublibraryapi-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
Pertanyaan tentang LibraryAPI MCP
Bagaimana cara menambahkan LibraryAPI MCP ke Claude Code?
Jalankan claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan LibraryAPI MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan LibraryAPI MCP?
Server ini menyediakan 6 tool, termasuk find_libraries_near_address, find_libraries_near_coordinates, get_outlet, search_libraries, get_library.
Data perpustakaan jenis apa yang tersedia?
Data tersebut mencakup lokasi perpustakaan, koleksi, staf, jumlah kunjungan, program, dan keuangan berdasarkan survei IMLS.
Apakah saya bisa menemukan jam buka harian yang spesifik untuk suatu cabang perpustakaan?
Tidak, API ini menyediakan total jam buka tahunan atau mingguan, tetapi tidak menyertakan jam buka harian yang spesifik.