Yapay zeka ajanları için IMLS anketinden gelen ABD kamu kütüphanesi konumlarına, şube detaylarına ve koleksiyon verilerine erişim sağlar.
Ayrıca bilinen adı library-api/libraryapi-mcp, libraryapi-mcp
- Yıldızlar
- 0
- Araçlar
- 6
- İndirmeler, 30 gün
- 133
- En son sürüm
- 0.1.3
- Son commit
- 4 Eki 2026
- Lisans
- —
LibraryAPI MCP nedir?
LibraryAPI bir MCP sunucusudur. Yapay zeka ajanları için IMLS anketinden gelen ABD kamu kütüphanesi konumlarına, şube detaylarına ve koleksiyon verilerine erişim sağlar. 6 araç sunar; örneğin find_libraries_near_address, find_libraries_near_coordinates, get_outlet.
Özet, projenin README dosyasından oluşturuldu
LibraryAPI MCP sunucusu hakkında
LibraryAPI, yapay zeka asistanlarına federal IMLS Kamu Kütüphaneleri Anketi'nden alınan Amerika Birleşik Devletleri kamu kütüphanesi verilerine erişim imkanı sunar. Geliştiriciler, konum tabanlı aramaları ve idari veri alımını etkinleştirmek için bu sunucuyu Claude Desktop veya Cursor gibi MCP uyumlu istemcilere entegre edebilirler. Sunucu, ajanların tüm kütüphane sistemleri ile bireysel şubeleri ayırt etmesine olanak tanıyan belirli araçlar sunarak çalışır.
Kullanıcılar sunucuyu pip aracılığıyla kurabilir veya doğrudan uvx kullanarak çalıştırabilirler. Erişim için libraryapi.dev adresinden alınan bir LIBRARYAPI_KEY gereklidir; burada ayda 500 istek ile sınırlı ücretsiz bir katman sunulmaktadır. Mevcut araç seti; yakınlık aramaları için find_libraries_near_address, isim veya şehre göre sistemleri bulmak için search_libraries ve eyalet genelindeki istatistikler için get_state_summary araçlarını içerir. Veriler yıllık ve haftalık toplam açık kalma sürelerini içerse de şubeler için belirli günlük açılış saatlerini sağlamaz.
Neler yapabilirsiniz
- 1Yakındaki kütüphane şubelerini bulmaBelirli bir sokak adresine veya koordinat setine en yakın kamu kütüphanesi konumlarını bulun.
- 2Eyalet genelindeki kütüphane istatistiklerini analiz etmeBelirli bir eyaletteki tüm kamu kütüphaneleri için toplam sayıları ve koleksiyon büyüklüklerini getirin.
- 3Detaylı şube bilgilerini almaBenzersiz bir ID kullanarak belirli bir kütüphane şubesi için eksiksiz bir kayıt alın.
- 4Kütüphane sistemlerini aramaİsim, şehir veya eyalet araması yaparak idari kütüphane birimlerini tanımlayın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
LibraryAPI MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleLibraryAPI MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcpLibraryAPI MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}LibraryAPI MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"libraryapi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}LibraryAPI MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"libraryapi-mcp","type":"stdio","command":"uvx","args":["libraryapi-mcp"],"env":{"LIBRARYAPI_KEY":"<YOUR_LIBRARYAPI_KEY>"}}'LibraryAPI MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}LibraryAPI MCP'yi Codex içine yükleyin
$ codex mcp add libraryapi-mcp --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' -- uvx libraryapi-mcpLibraryAPI MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.libraryapi-mcp] command = "uvx" args = ["libraryapi-mcp"] [mcp_servers.libraryapi-mcp.env] LIBRARYAPI_KEY = "<YOUR_LIBRARYAPI_KEY>"
LibraryAPI MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp uvx -- libraryapi-mcpLibraryAPI MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}LibraryAPI MCP araçları 6
README dosyasından algılandı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 | — |
Yapılandırma
LIBRARYAPI_KEYGerekliGizliAPI key from https://libraryapi.dev (free tier: 500 requests/month)
| Ad | Açıklama | Sunucu |
|---|---|---|
| LIBRARYAPI_KEY | API key from https://libraryapi.dev (free tier: 500 requests/month) | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirlibrary-api/libraryapi-mcp is public and reachablegithub.com/library-api/libraryapi-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorlibraryapi-mcp names library-api/libraryapi-mcp as sourcepypi.org/project/libraryapi-mcp/ ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-04github.com/library-api/libraryapi-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from libraryapi-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok30 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
LibraryAPI MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
LibraryAPI MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
LibraryAPI MCP hangi araçları sunar?
6 araç sunar; bunlar arasında find_libraries_near_address, find_libraries_near_coordinates, get_outlet, search_libraries, get_library yer alır.
Ne tür kütüphane verileri mevcut?
Veriler; IMLS anketine dayalı olarak kütüphane konumlarını, koleksiyonları, personel durumunu, ziyaret sayılarını, programları ve finansal bilgileri içerir.
Bir kütüphane şubesinin belirli günlük açılış saatlerini bulabilir miyim?
Hayır, API yıllık veya haftalık toplam açık kalma sürelerini sağlar ancak belirli günlük açılış saatlerini içermez.