安装
npx -y mcp-open-library适合谁
适合要让助手检索 Open Library 上的图书与作者信息的人。官方把它写成面向 Open Library API 的 MCP 服务器,用来 search for book and author information。仓库标题还写明对接的是 Internet Archive 的 Open Library API。
它不是本地藏书目录,也不是借阅系统。所有已点名工具都是只读查找。没有 API key 字段出现在官方配置里。
官方页面:
https://github.com/8enSmith/mcp-open-library
3 分钟完成第一次尝试
官方写明 Nothing to install or build。把客户端指向这个包,第一次运行由 npx 拉取:
{
"mcpServers": {
"mcp-open-library": {
"command": "npx",
"args": ["-y", "mcp-open-library"]
}
}
}
从 v1.0.3 起,它以 io.github.8enSmith/mcp-open-library 发布到 official MCP Registry;支持 registry 的客户端可以按该名字安装。不要另找未出现的安装器。
前置条件:本机能跑 npx。第一次请用你已经知道的书名或作者名,不要编造 ISBN 或 Author Key。官方没有要求密钥。
配置位置:mcpServers.mcp-open-library。官方没有点名必须使用的客户端产品或配置文件路径。
第一次调用必须用已点名的工具 search_books。它可以按 query、title、author、subject、place、person、publisher 和 ISBN 的任意组合检索。成功信号:返回一页结果,并带上 num_found;默认 limit 为 10,至多 50。不要先调用需要 Author Key 的 get_author_info。
readOnlyHint 不是零风险。官方同时写了 openWorldHint:请求会离开本机,打到 Open Library API。客户端可能因此跳过“会改东西”的确认框,但网络与隐私边界仍在。
使用案例
案例一:按组合条件找书。调用 search_books。结果分页:每页至多 limit 条(default 10, maximum 50),用 offset 翻页(maximum 1000),并返回 num_found。官方没有写排序或语言过滤。
案例二:按书名或作者名做更窄的查找。调用 get_book_by_title,或调用 get_authors_by_name。官方只写按 title / name 搜索,没有写模糊匹配规则。若已经有 Open Library Author Key,可以用 get_author_info 取详细信息;没有 Key 就不要编一个。
使用边界
能力边界:连续说明里点名的工具是 search_books、get_book_by_title、get_authors_by_name、get_author_info。没有出现的封面或 ID 取书工具不要补。
分页边界:limit 默认 10、最大 50;offset 最大 1000。超出官方数字的翻页不要假设可用。
安装边界:npx 即拉,或 registry 名 io.github.8enSmith/mcp-open-library。官方没有写离线缓存。