
Spines
io.github.SuperAgentic由 GitHub 帳號 SuperAgentic 發布v1.1.0更新於 Oct 24, 2026
Access book collections, reading lists, and bookshelf recognition from AI assistants.
概覽
把 AI 助理連接到 SPINES 書籍收藏,可搜尋書籍、瀏覽書櫃、管理閱讀清單,並從書櫃照片辨識書籍。
- 可以做什麼
- 依書名、作者或 ISBN 搜尋書籍並查看書籍詳細資料
- 瀏覽收藏、分類與人物檔案,找出常被擺在一起的書籍
- 將書籍加入閱讀清單或從中移除
- 從一張或多張書櫃照片辨識書籍並存成一個收藏
- 查詢每日辨識額度餘額
- 以資源形式提供收藏、書籍、人物檔案與閱讀清單,並提供書櫃分析、推薦與收藏比較提示詞
- 適用情境
- 適合已在使用 SPINES 書庫、希望助理協助查書、整理閱讀清單,或把實體書櫃照片轉成數位收藏並進行分析與推薦的情境。
- 執行需求
- 透過 npm 套件 @spines/mcp-server 在本機執行,需要 Node.js 18 以上版本,並在 Claude Desktop、VS Code 或 Cursor 等 MCP 用戶端中設定。需要 SPINES API 金鑰,放在 SPINES_API_KEY 環境變數中。選用設定:SPINES_API_URL、SPINES_DEBUG,以及 SPINES_LLM_PROVIDER 與 SPINES_LLM_API_KEY。需要能連線到 SPINES API 的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Spines,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
SPINES MCP Server
Access SPINES book collections, reading lists, and bookshelf data from AI assistants via the Model Context Protocol.
Features
- Recognize books from photos of a bookshelf; several photos of one shelf become one collection
- Search books by title, author, or ISBN
- Browse and filter book collections
- Manage reading lists (add and remove books)
- Explore personas, categories, and books commonly shelved together
- AI prompts for shelf analysis and book recommendations
Quick Start
Prerequisites
- Node.js 18+
- A SPINES API key (get one here)
Installation
Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
VS Code / Cursor
Add to your MCP settings:
Environment Variables
Tools
Read Tools
Write Tools
Tool Details
search_books
get_book_details
get_collection
list_collections
list_categories
get_persona
get_book_pairings
check_credits
add_to_reading_list
remove_from_reading_list
recognize_bookshelf
Send either image_url / image_base64 or images, not both. Example:
- Photo limit: 4 per request with a regular key. A book that appears on two photos is kept once.
- Credits: each photo uses one credit; the request needs at least one to start. With
SPINES_LLM_PROVIDER/SPINES_LLM_API_KEYset, no credits are used. - Prefer URLs. Base64 photos over 4 MB in total do not fit in one request.
- Duplicates: a photo already in SPINES fails the whole request (
RECOGNIZE_IMAGE_DUPLICATE, with the index of that photo). - Timing: the tool waits while the server reads every photo, then polls until book matching finishes (up to 2 minutes). It returns the finished collection, or the job's current status (with its
job_id) if matching is still running or its status could not be read. If the first step times out (5 minutes), the collection may still be created: checklist_collectionsbefore trying again, since a retry uses credits again.
Resources
Prompts
Troubleshooting
Development
License
MIT
來源:README.md,提交 64fb770
工具
0版本歷史
3- v1.1.0最新Oct 14, 2026
- v1.0.3Oct 14, 2026
- v1.0.2Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分