IMLS調査に基づく米国の公共図書館の所在地、分館の詳細、および蔵書データへのアクセスをAIエージェントに提供します。
別名 library-api/libraryapi-mcp, libraryapi-mcp
- スター
- 0
- ツール
- 6
- ダウンロード数(30日間)
- 133
- 最新バージョン
- 0.1.3
- 最終コミット
- 2026年10月4日
- ライセンス
- —
LibraryAPI MCPとは
LibraryAPIはMCPサーバーです。 IMLS調査に基づく米国の公共図書館の所在地、分館の詳細、および蔵書データへのアクセスをAIエージェントに提供します。. 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
LibraryAPI MCPが提供するツールは
6個のツールを提供しており、find_libraries_near_address, find_libraries_near_coordinates, get_outlet, search_libraries, get_libraryなどがあります。
どのような図書館データが利用可能ですか?
IMLS調査に基づいた、図書館の所在地、蔵書、職員数、来館者数、プログラム、および財務データが含まれます。
特定の分館の毎日の開館時間を調べることができますか?
いいえ、このAPIは年間または週間の総開館時間を提供しますが、特定の毎日の開館時間は含まれていません。