Skip to main content
Glama
GetSpines

SPINES MCP Server

Official
by GetSpines

SPINES MCP Server

从 AI 助手访问 SPINES 图书收藏、阅读列表和书架数据,通过 Model Context Protocol

功能

  • 按标题、作者或 ISBN 搜索图书

  • 浏览和筛选图书收藏

  • 管理阅读列表(添加和移除图书)

  • 探索人物角色和分类

  • 用于书架分析和图书推荐的 AI 提示

Related MCP server: apple-books-mcp

快速开始

前提条件

安装

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"
    }
  }
}

环境变量

变量

必填

默认值

描述

SPINES_API_KEY

-

你的 API 密钥

SPINES_API_URL

https://spins.app/api/v1

API 基础 URL

SPINES_DEBUG

false

向 stderr 输出详细日志

工具

读取工具

工具

描述

search_books

按标题、作者或 ISBN 搜索图书

get_book_details

获取特定图书的完整详细信息

get_collection

获取一个图书收藏及其所有图书

list_collections

列出你的收藏,支持可选筛选条件

list_categories

列出所有已批准的图书分类

get_persona

获取关于人物角色的详细信息

写入工具

工具

描述

add_to_reading_list

将图书添加到阅读列表

remove_from_reading_list

从阅读列表中移除图书

工具详情

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 ID

get_collection

collection_id: string  - The collection's unique ID

list_collections

limit?: number        - Max results (1-50, default 20)
cursor?: string       - Pagination cursor
persona_id?: string   - Filter by persona
category_id?: string  - Filter by category

add_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://collection/{id}

带有元数据的图书收藏

spines://book/{id}

完整的图书详细信息

spines://persona/{id}

人物角色资料和收藏

spines://reading-lists

用户的阅读列表

提示

提示

描述

analyze_shelf

分析收藏中的主题和阅读模式

recommend_books

根据你的书库获取推荐

compare_collections

比较两个收藏的相似之处

故障排除

问题

解决方案

"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

A
license - permissive license
Not graded
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

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

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to help users manage their reading experience by searching books, tracking reading progress, managing bookmarks, and generating personalized recommendations and summaries.
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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
  • A
    license
    A
    quality
    A
    maintenance
    Connects AI assistants to the Hardcover book library, enabling natural language book searches, reading status updates, list management, and library exploration.
    31
    5
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Bridges your Calibre e-book library with AI assistants via the Model Context Protocol, enabling natural-language library management, semantic search, RAG, and agentic workflows.
    39
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

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