安裝
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。官方沒有寫離線快取。