关于 LibraryAPI
LibraryAPI 为 AI Agent 和应用提供美国公共图书馆及分馆数据,数据基于联邦 IMLS 公共图书馆调查。它支持附近搜索、图书馆系统查询和州级汇总,提供馆藏及服务数据,但不包含每日开放时间。
主要功能
- 01按地址查找附近分馆
- 02按经纬度搜索附近分馆
- 03查询图书馆系统与分馆记录
- 04获取州级图书馆统计
- 05访问馆藏、人员和服务数据
适用场景
- 01按指定地址查找附近分馆
- 02按名称、州或城市查找图书馆系统
- 03使用分馆和馆藏数据构建公共服务应用
MCP 相关
该 MCP 服务提供六种工具,用于搜索附近分馆、获取分馆和系统记录,以及查询州级汇总。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
6收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | |
| address | string | 是 | |
| radius_miles | number | 否 | |
| include_closed | boolean | 否 |
详细介绍
libraryapi-mcp
mcp-name: dev.libraryapi/libraryapi-mcp
适用于 libraryapi.dev 的 MCP 服务 — 面向 AI Agent 的美国公共图书馆数据。
将图书馆查询作为工具提供给任何兼容 MCP 的 AI 助手(Claude、Cursor、Copilot 等)。基于美国联邦 IMLS 公共图书馆调查数据构建,属于公有领域,可用于商业用途。
安装
pip install libraryapi-mcp
也可以直接通过 uvx 运行(无需安装):
uvx libraryapi-mcp
配置
Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"libraryapi": {
"command": "uvx",
"args": ["libraryapi-mcp"],
"env": {
"LIBRARYAPI_KEY": "your_api_key_here"
}
}
}
}
Cursor / 其他 MCP 客户端
{
"mcpServers": {
"libraryapi": {
"command": "uvx",
"args": ["libraryapi-mcp"],
"env": {
"LIBRARYAPI_KEY": "your_api_key_here"
}
}
}
}
在 libraryapi.dev 获取免费 API 密钥 — 每月 500 次请求,无需信用卡。
可用工具
| 工具 | 描述 |
|---|---|
find_libraries_near_address | 查找距离美国街道地址最近的分馆 |
find_libraries_near_coordinates | 同上,但使用经纬度(跳过地理编码) |
get_outlet | 按 ID 获取单个分馆的完整记录 |
search_libraries | 按名称、州或城市搜索图书馆 系统 |
get_library | 按 FSCS ID 获取完整的系统档案 |
get_state_summary | 全州图书馆统计汇总 |
系统与分馆: 系统是行政实体(例如“芝加哥公共图书馆”);分馆是单个馆点。邻近搜索会返回分馆。
示例
配置完成后,你可以向 AI 助手询问:
“纽约第五大道 350 号附近最近的三家公共图书馆在哪里?”
“佛蒙特州有多少家公共图书馆分馆?馆藏总量是多少?”
“我正在开发一款公民服务应用 — 请以 JSON 格式列出芝加哥市中心 5 英里范围内的所有图书馆分馆。”
数据说明
IMLS 调查涵盖馆点、馆藏、人员配置、到访情况、活动和财务数据。它提供开放时长总计(按年和按周),但不提供每日开放时间 — 因此,这个 API 可以告诉你某个分馆每周开放约 45 小时,但无法告诉你它早上 9 点开门。
链接
- 网站: libraryapi.dev
- PyPI: pypi.org/project/libraryapi-mcp
- REST API 文档: libraryapi.dev/docs
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。