mcp-library-search
This server lets you search, locate, and inspect library books via three tools, with the server schema currently supporting Shanghai only.
search_books: Search by keyword (title, ISBN, author) and get paginated results withbook_idand availability summaries.find_book_availability: Check which branches hold a book, optionally only available copies, with due dates for borrowed items.get_book_detail: Retrieve full book metadata including ISBN, call number, and summary.All tools accept a
cityparameter (defaultshanghai); the schema lists no other integrated cities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-library-search 帮我查下《三体》在上海哪个图书馆能借到,要现在可借的"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp_library_search
MCP server:查询城市图书馆的馆藏与可借状态——回答"这本书在哪些馆能借到"。
支持情况
城市 | 标识 | 状态 | 数据源 |
上海 |
| ✅ 已接入 | 上海中心图书馆"一卡通"总分馆体系(900+ 网点,含地铁站 24 小时自助机) |
广州 |
| ✅ 已接入 | 广州图书馆(图创 Interlib) |
杭州 |
| ✅ 已接入 | 杭州图书馆+浙江图书馆双源合并(同一本书跨馆归并成一条结果) |
深圳 |
| ✅ 已接入 | 深圳图书馆之城统一平台(自研 JSON API,167 馆) |
天津 |
| ✅ 已接入 | 天津图书馆等三源合并(主馆+少儿馆+中新友好图书馆,同一本书跨馆归并成一条结果) |
重庆 |
| ✅ 已接入 | 重庆 InDigLib 集群数字图书馆 |
合肥 |
| ✅ 已接入 | 安徽省图书馆+合肥市图书馆双源合并(同一本书跨馆归并成一条结果) |
南京 |
| ✅ 已接入 | 金陵图书馆+12 区馆联合目录 + 南京图书馆(江苏省图)双源合并,馆藏到单册级;南图源走 Ex Libris ALEPH,有验证码墙 |
成都 |
| ✅ 已接入 | 成都平原经济区联合目录(图创 Interlib pro2018) |
宁波 |
| ✅ 已接入 | 宁波市图书馆全市联合目录(图创 tcc-opac) |
绍兴 |
| ✅ 已接入 | 绍兴市公共图书馆联合目录(图创 Interlib pro2018) |
大连 |
| ✅ 已接入 | 大连地区网上联合目录(SirsiDynix iLink) |
金华 |
| ✅ 已接入 | 金华市图书馆(UILAS HTML OPAC) |
江阴 |
| ✅ 已接入 | 江阴市图书馆(图创 Interlib,含农家书屋等 24H 网点) |
温州 |
| ✅ 已接入 | 温州市图书馆(图创 Interlib,全市总分馆体系) |
台州 |
| ✅ 已接入 | 台州市图书馆(图创 Interlib pro2018,含地铁站点通借) |
青岛 |
| ✅ 已接入 | 青岛市公共图书馆联合目录(图创 Interlib,26 馆联合,检索走站点 Solr 通道) |
无锡 |
| ✅ 已接入 | 无锡市新吴区图书馆(图星 LibStar Find;市图书馆源预留未接入) |
扬州 |
| ✅ 已接入 | 扬州市图书馆联盟联合目录(汇文 uopac,与南京金陵源同系统;站点 securitycam 反爬按静态挑战处理) |
苏州 |
| ✅ 已接入 | 苏州图书馆+苏州工业园区图书馆双源合并(图创 Interlib,馆藏到单册级) |
徐州 |
| ✅ 已接入 | 徐州市图书馆全市联合目录(图星 LibStar Find,含鼓楼区馆等) |
淮安 |
| ✅ 已接入 | 淮安市图书馆全市联合目录(图星 LibStar Find,含少儿馆、清江浦区馆等) |
盐城 |
| ✅ 已接入 | 盐城市图书馆(图星 LibStar Find,单实例) |
丽水 |
| ✅ 已接入 | 丽水市公共图书馆联合目录(图创 Interlib pro2018,含景宁/庆元/缙云等县馆) |
舟山 |
| ✅ 已接入 | 舟山市图书馆(UILAS 知识检索平台) |
陕西省图书馆 |
| ✅ 已接入 | 陕西省图书馆(新版 UILAS REST 平台,省级馆馆址西安) |
西安 |
| ✅ 已接入 | 西安市公共图书馆集群平台(图创 Interlib pro2018,上下文 |
咸阳 |
| ✅ 已接入 | 咸阳市公共图书馆联盟(图创 Interlib) |
宝鸡 |
| ✅ 已接入 | 宝鸡市公共图书馆集群平台(图创 Interlib) |
安康 |
| ✅ 已接入 | 安康市图书馆(图创 Interlib pro2018) |
汉中 |
| ✅ 已接入 | 汉中市图书馆全市联合目录(图星 LibStar Find,含洋县等县馆) |
榆林 |
| ✅ 已接入 | 榆林市图书馆(新版 UILAS REST 平台) |
海口 |
| ✅ 已接入 | 海口市图书馆(图创 Interlib;海口图书馆为同一实例) |
株洲 |
| ✅ 已接入 | 株洲市图书馆(图创 Interlib) |
孝感 |
| ✅ 已接入 | 孝感市图书馆(图创 Interlib) |
荆门 |
| ✅ 已接入 | 荆门市图书馆(图创 Interlib) |
湖南图书馆 |
| ✅ 已接入 | 湖南图书馆省级馆(图创 Interlib) |
福建省图书馆 |
| ✅ 已接入 | 福建省图书馆(图创 Interlib) |
阳江 |
| ✅ 已接入 | 阳江市图书馆(图创 Interlib) |
淄博 |
| ✅ 已接入 | 淄博市图书馆(图创 Interlib) |
德州 |
| ✅ 已接入 | 德州市图书馆(图创 Interlib) |
周口 |
| ✅ 已接入 | 周口市图书馆(图创 Interlib) |
泉州 |
| ✅ 已接入 | 泉州市图书馆(图创 Interlib) |
通辽 |
| ✅ 已接入 | 通辽市图书馆(图创 Interlib) |
河源 |
| ✅ 已接入 | 河源市图书馆(图创 Interlib) |
黑龙江省图书馆 |
| ✅ 已接入 | 黑龙江省图书馆(图创 Interlib,检索走内嵌 Solr) |
长春 |
| ✅ 已接入 | 长春市图书馆(图创 Interlib,检索走内嵌 Solr) |
唐山 |
| ✅ 已接入 | 唐山市图书馆(图创 Interlib,检索走内嵌 Solr) |
包头 |
| ✅ 已接入 | 包头市图书馆(图创 Interlib,检索走内嵌 Solr) |
乌海 |
| ✅ 已接入 | 乌海市图书馆(图创 Interlib,检索走内嵌 Solr) |
呼和浩特 |
| ✅ 已接入 | 呼和浩特市图书馆(图创 Interlib,检索走内嵌 Solr) |
潮州 |
| ✅ 已接入 | 潮州市图书馆(图创 Interlib,检索走内嵌 Solr) |
兰州 |
| ✅ 已接入 | 兰州市图书馆(新版 UILAS REST 平台) |
江门 |
| ✅ 已接入 | 江门市图书馆(新版 UILAS REST 平台) |
河南省图书馆 |
| ✅ 已接入 | 河南省图书馆(老版 UILAS HTML OPAC) |
济南 |
| ✅ 已接入 | 济南市图书馆(图创 tcc-opac 全市联合目录) |
鄂尔多斯 |
| ✅ 已接入 | 鄂尔多斯市图书馆(图创 tcc-opac) |
丽江 |
| ✅ 已接入 | 丽江市图书馆全市联合目录(图创 Interlib,含古城区/玉龙/宁蒗/华坪等分馆) |
来宾 |
| ✅ 已接入 | 来宾市图书馆全市联合目录(图创 Interlib,含各镇/县分馆) |
黄石 |
| ✅ 已接入 | 黄石市图书馆(图创 Interlib) |
遵义 |
| ✅ 已接入 | 遵义市图书馆(图创 Interlib) |
黔东南 |
| ✅ 已接入 | 黔东南州图书馆(图创 Interlib,含乡镇分馆与城市书房) |
黔南 |
| ✅ 已接入 | 黔南州图书馆(图创 Interlib) |
曲靖 |
| ✅ 已接入 | 曲靖市图书馆(图创 Interlib) |
临沧 |
| ✅ 已接入 | 临沧市图书馆(图创 Interlib,含区县馆与乡镇分馆) |
楚雄 |
| ✅ 已接入 | 楚雄州图书馆(图创 Interlib) |
红河 |
| ✅ 已接入 | 红河州图书馆(图创 Interlib) |
德宏 |
| ✅ 已接入 | 德宏州图书馆(图创 Interlib) |
怒江 |
| ✅ 已接入 | 怒江州图书馆(图创 Interlib) |
德清 |
| ✅ 已接入 | 德清县图书馆(图创 Interlib,检索走内嵌 Solr) |
西双版纳 |
| ✅ 已接入 | 西双版纳州图书馆(图创 Interlib,检索走内嵌 Solr) |
太原 |
| ✅ 已接入 | 太原市图书馆(图创 Interlib,检索走内嵌 Solr) |
武汉 |
| ✅ 已接入 | 武汉图书馆(图创 Interlib) |
大庆 |
| ✅ 已接入 | 大庆市图书馆(图创 Interlib,应用上下文为根路径) |
枣庄 |
| ✅ 已接入 | 枣庄市图书馆(新版 UILAS REST 平台) |
乐山 |
| ✅ 已接入 | 乐山市图书馆(借四川省图书馆联合目录过滤;检索页为验证码墙,未过码时提示在浏览器手动解封) |
郑州 |
| ✅ 已接入 | 郑州图书馆(SirsiDynix Enterprise/VSE,服务端渲染;每页固定 12 条) |
更多城市 | — | 欢迎提需求或贡献适配器 | 北京等因站点侧限制暂未接入,详见 docs/data-sources/README.md |
Related MCP server: NLB Singapore Library MCP Server
安装
Claude Code
claude mcp add mcp-library-search -- uvx mcp_library_searchClaude Desktop
在 claude_desktop_config.json 里加:
"mcpServers": {
"mcp-library-search": {
"command": "uvx",
"args": ["mcp_library_search"]
}
}改完重启桌面版。
使用
接入后提供 3 个 tool,查询链路为:先 search_books 按关键字找到 book_id,再用它查馆藏或详情。都带 region 与 city 两个定位参数:region 是地区标识(取域名后缀),默认 cn(中国);city 默认 shanghai。未接入的地区或城市会返回明确提示:
tool | 作用 |
| 按关键字(书名、ISBN、作者等)搜书,返回分页列表,每条带 |
| 查这本书在哪些馆有、是否可借,可借的馆排前面; |
| 查这本书的完整介绍(ISBN、索书号、内容简介) |
典型用法:对 Claude 说"帮我查《三体》在哪个馆能借到" → 搜书拿到 book_id → 查各馆可借状态 → 就近推荐。
赞赏
如果这个项目帮到了你,欢迎打赏支持:
致谢
shanghai-library-book-search-python——上海图书馆检索能力的来源(Apache-2.0)。
完整的第三方组件列表、归属与变更说明见 NOTICE。
Available Tools
3 toolsfind_book_availabilityFind Book AvailabilityA
查询指定图书在各分馆的馆藏与可借状态,可借的馆排前面。
已借出的馆藏可能带 due_date(预计归还时间,YYYY-MM-DD),仅在 only_available=False 时出现;数据源查不到时为空串。
参数: book_id:search_books 返回的图书 ID,需与 search_books 使用同一 city city:城市标识,默认 "shanghai" only_available:True(默认)只返回当前可借的馆;False 返回全部馆藏
Inputs: book_id (required), city, only_available. Returns: result
get_book_detailGet Book DetailA
查询指定图书的完整介绍:书名、作者、出版社、出版年、ISBN、索书号、内容简介。
上海数据源没有独立简介区块,内容简介取自书目"附注"字段,可能带有 "新版本册内容:"之类的原生前缀。
参数: book_id:search_books 返回的图书 ID,需与 search_books 使用同一 city city:城市标识,默认 "shanghai"
Inputs: book_id (required), city. Returns: isbn, title, author, book_id, +4 more
search_booksSearch BooksA
按关键字搜索城市图书馆的馆藏图书,返回分页列表。
已接入城市:shanghai(上海,全市 900+ 网点,含地铁站 24 小时自助机);其他城市待接入。 keyword 可以是书名、ISBN、作者名等。每条结果带 book_id,是后续查询的凭据。 total_results 为 null 表示数据源不提供总数:用 page 继续翻页, 直到 has_next 为 false 或 books 为空。
参数: keyword:书名、ISBN、作者等检索词 city:城市标识,默认 "shanghai" page:页码,默认 1 limit:每页条数,默认 20
Inputs: keyword (required), city, page, limit. Returns: page, books, has_next, total_pages, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: search_books for keyword search, find_book_availability for branch-level availability, and get_book_detail for bibliographic details. Despite overlap in parameters (book_id, city), the descriptions and return types make the boundaries unambiguous.
All tool names use snake_case with a verb_noun pattern (search_books, find_book_availability, get_book_detail). The slight variation in verbs (search/find/get) is natural and consistent, not confusing.
Three tools is slightly lean but well-scoped for a library search server. Each tool earns its place, and there is no bloat. A few more tools (e.g., branch listing) could add value without being excessive.
The surface covers the core search lifecycle: search, availability, and detail. Minor gaps exist (e.g., no way to list supported cities or browse branches), but these are workaroundable and not critical for the stated purpose.
Maintenance
Related MCP Connectors
Personalised book recommendations, filtered to what's on your public library's shelf right now.
Search Chinese books with Douban ratings, AI book guides and curated toplists. Free, no API key.
Read-only search and retrieval of published books, articles and authors, with public catalog links.
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Related MCP Servers
- AlicenseCqualityCmaintenanceProvides comprehensive access to South Korea's National Library information system, enabling searches across 1,000+ public libraries, real-time book availability checks, borrowing trends, and location-based library discovery.2729 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables searching the National Library Board Singapore catalogue by title, author, ISBN, or subject, and checking real-time availability of books across library branches.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables multi-source search and verified download of public-domain and open-license ebooks (Chinese/English) through a unified MCP interface.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables users to look up digitized-book holdings and catalog records by standard identifiers, retrieve bibliographic metadata, and check whether readable full-view copies are available.311 npmMIT