Skip to main content
Glama
GetSpines

SPINES MCP Server

Official
by GetSpines

SPINES MCP Server

SPINES のブックコレクション、読書リスト、本棚データに、Model Context Protocol を介して AI アシスタントからアクセスできます。

特徴

  • タイトル、著者、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

類似性について2つのコレクションを比較

トラブルシューティング

問題

解決策

"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