SPINES MCP Server
OfficialSPINES MCP Server
从 AI 助手访问 SPINES 图书收藏、阅读列表和书架数据,通过 Model Context Protocol。
功能
按标题、作者或 ISBN 搜索图书
浏览和筛选图书收藏
管理阅读列表(添加和移除图书)
探索人物角色和分类
用于书架分析和图书推荐的 AI 提示
Related MCP server: apple-books-mcp
快速开始
前提条件
Node.js 18+
一个 SPINES API 密钥(在此获取)
安装
npm install -g @spines/mcp-server配置
Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json(macOS)或 %APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"spines": {
"command": "npx",
"args": ["-y", "@spines/mcp-server"],
"env": {
"SPINES_API_KEY": "gtspn_live_your_key_here"
}
}
}
}VS Code / Cursor
添加到你的 MCP 设置:
{
"spines": {
"command": "npx",
"args": ["-y", "@spines/mcp-server"],
"env": {
"SPINES_API_KEY": "gtspn_live_your_key_here"
}
}
}环境变量
变量 | 必填 | 默认值 | 描述 |
| 是 | - | 你的 API 密钥 |
| 否 |
| API 基础 URL |
| 否 |
| 向 stderr 输出详细日志 |
工具
读取工具
工具 | 描述 |
| 按标题、作者或 ISBN 搜索图书 |
| 获取特定图书的完整详细信息 |
| 获取一个图书收藏及其所有图书 |
| 列出你的收藏,支持可选筛选条件 |
| 列出所有已批准的图书分类 |
| 获取关于人物角色的详细信息 |
写入工具
工具 | 描述 |
| 将图书添加到阅读列表 |
| 从阅读列表中移除图书 |
工具详情
search_books
query: string - Search query (title, author, or ISBN)
limit?: number - Max results (1-50, default 10)get_book_details
book_id: string - The book's unique IDget_collection
collection_id: string - The collection's unique IDlist_collections
limit?: number - Max results (1-50, default 20)
cursor?: string - Pagination cursor
persona_id?: string - Filter by persona
category_id?: string - Filter by categoryadd_to_reading_list
book_id: string - The book to add
list_name?: string - List name (default: "want_to_read")remove_from_reading_list
entry_id: string - The reading list entry ID to remove资源
URI | 描述 |
| 带有元数据的图书收藏 |
| 完整的图书详细信息 |
| 人物角色资料和收藏 |
| 用户的阅读列表 |
提示
提示 | 描述 |
| 分析收藏中的主题和阅读模式 |
| 根据你的书库获取推荐 |
| 比较两个收藏的相似之处 |
故障排除
问题 | 解决方案 |
"SPINES_API_KEY is required" | 在你的 MCP 客户端配置中设置该环境变量 |
401 错误 | 检查你的 API 密钥是否有效且未过期 |
403 错误 | 你的密钥可能缺少所需的权限范围 |
429 错误 | 请求频率受限——请等待后重试 |
工具未出现 | 重启你的 MCP 客户端 |
开发
git clone https://github.com/GetSpines/mcp-server
cd mcp-server
npm install
npm run build
npm test许可证
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to help users manage their reading experience by searching books, tracking reading progress, managing bookmarks, and generating personalized recommendations and summaries.
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to read and write local Apple Books library, collections, and annotations. Supports searching, exporting, and modifying books and highlights via MCP tools.MIT
- AlicenseAqualityAmaintenanceConnects AI assistants to the Hardcover book library, enabling natural language book searches, reading status updates, list management, and library exploration.315MIT
- AlicenseNot gradedqualityBmaintenanceBridges your Calibre e-book library with AI assistants via the Model Context Protocol, enabling natural-language library management, semantic search, RAG, and agentic workflows.39MIT
Related MCP Connectors
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Search books and authors, fetch editions, browse subjects, and resolve cover images.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/GetSpines/mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server