Proporciona acceso a ubicaciones de bibliotecas públicas de EE. UU., detalles de sucursales y datos de colecciones de la encuesta IMLS para agentes de IA.
También conocido como library-api/libraryapi-mcp, libraryapi-mcp
- Stars
- 0
- Herramientas
- 6
- Descargas, 30 días
- 133
- Última versión
- 0.1.3
- Último commit
- 4 oct 2026
- Licencia
- —
¿Qué es LibraryAPI MCP?
LibraryAPI es un MCP server. Proporciona acceso a ubicaciones de bibliotecas públicas de EE. UU., detalles de sucursales y datos de colecciones de la encuesta IMLS para agentes de IA. Expone 6 herramientas, como find_libraries_near_address, find_libraries_near_coordinates, get_outlet.
Resumen generado a partir del README del proyecto
Acerca del MCP server de LibraryAPI
LibraryAPI ofrece a los asistentes de IA acceso a datos de bibliotecas públicas de Estados Unidos provenientes de la encuesta federal IMLS Public Libraries Survey. Los desarrolladores pueden integrar este MCP server en clientes compatibles con MCP como Claude Desktop o Cursor para permitir búsquedas basadas en la ubicación y la recuperación de datos administrativos. El servidor funciona exponiendo herramientas específicas que permiten a los agentes distinguir entre sistemas de bibliotecas completos y sucursales individuales.
Los usuarios pueden instalar el servidor vía pip o ejecutarlo directamente usando uvx. El acceso requiere una LIBRARYAPI_KEY obtenida en libraryapi.dev, que ofrece un nivel gratuito limitado a 500 solicitudes por mes. El conjunto de herramientas disponibles incluye find_libraries_near_address para búsquedas por proximidad, search_libraries para encontrar sistemas por nombre o ciudad, y get_state_summary para estadísticas estatales. Aunque los datos incluyen totales de horas de apertura anuales y semanales, no proporcionan horarios de apertura diarios específicos para las sucursales.
Qué puedes hacer con él
- 1Localizar sucursales de bibliotecas cercanasEncuentra las ubicaciones de bibliotecas públicas más cercanas a una dirección de calle específica o a un conjunto de coordenadas.
- 2Analizar estadísticas de bibliotecas estatalesRecupera recuentos totales y tamaños de colecciones para todas las bibliotecas públicas dentro de un estado específico.
- 3Recuperar información detallada de una sucursalObtén un registro completo de una sucursal de biblioteca específica utilizando su ID único.
- 4Buscar sistemas de bibliotecasIdentifica entidades administrativas de bibliotecas buscando por su nombre, ciudad o estado.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar LibraryAPI MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar LibraryAPI MCP en Claude Code
$ claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcpInstalar LibraryAPI MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instalar LibraryAPI MCP en VS Code
.vscode/mcp.json
{
"servers": {
"libraryapi-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instalar LibraryAPI MCP en VS Code CLI
$ code --add-mcp '{"name":"libraryapi-mcp","type":"stdio","command":"uvx","args":["libraryapi-mcp"],"env":{"LIBRARYAPI_KEY":"<YOUR_LIBRARYAPI_KEY>"}}'Instalar LibraryAPI MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Instalar LibraryAPI MCP en Codex
$ codex mcp add libraryapi-mcp --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' -- uvx libraryapi-mcpInstalar LibraryAPI MCP en 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>"
Instalar LibraryAPI MCP en Gemini CLI
$ gemini mcp add -s user -e 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp uvx -- libraryapi-mcpInstalar LibraryAPI MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"libraryapi-mcp": {
"command": "uvx",
"args": [
"libraryapi-mcp"
],
"env": {
"LIBRARYAPI_KEY": "<YOUR_LIBRARYAPI_KEY>"
}
}
}
}Herramientas de LibraryAPI MCP 6
Detectado desde el 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 | — |
Configuración
LIBRARYAPI_KEYObligatorioSecretoAPI key from https://libraryapi.dev (free tier: 500 requests/month)
| Nombre | Descripción | Tipo |
|---|---|---|
| LIBRARYAPI_KEY | API key from https://libraryapi.dev (free tier: 500 requests/month) | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblelibrary-api/libraryapi-mcp is public and reachablegithub.com/library-api/libraryapi-mcp ↗Aprobado
- El paquete indica este repositorio como su origenlibraryapi-mcp names library-api/libraryapi-mcp as sourcepypi.org/project/libraryapi-mcp/ ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-10-04github.com/library-api/libraryapi-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from libraryapi-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias30 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre LibraryAPI MCP
¿Cómo agrego LibraryAPI MCP a Claude Code?
Ejecuta claude mcp add --env 'LIBRARYAPI_KEY=<YOUR_LIBRARYAPI_KEY>' libraryapi-mcp -- uvx libraryapi-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego LibraryAPI MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona LibraryAPI MCP?
Expone 6 herramientas, incluidas find_libraries_near_address, find_libraries_near_coordinates, get_outlet, search_libraries, get_library.
¿Qué tipo de datos de bibliotecas están disponibles?
Los datos incluyen ubicaciones de bibliotecas, colecciones, personal, visitas, programas y finanzas basados en la encuesta IMLS.
¿Puedo encontrar el horario de apertura diario específico de una sucursal?
No, la API proporciona totales de horas de apertura anuales o semanales, pero no incluye horarios de apertura diarios específicos.