Skip to main content
Glama
deenesjakoruzh
GetSpines

SPINES MCP Server

Official
by GetSpines
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

SPINES MCP Server

Greife über das Model Context Protocol aus KI-Assistenten auf SPINES-Büchersammlungen, Leselisten und Bücherregal-Daten zu.

Funktionen

  • Suche Bücher nach Titel, Autor oder ISBN

  • Durchsuche und filtere Büchersammlungen

  • Verwalte Leselisten (Bücher hinzufügen und entfernen)

  • Entdecke Personas und Kategorien

  • KI-Prompts für Regalanalyse und Buchempfehlungen

Related MCP server: apple-books-mcp

Schnellstart

Voraussetzungen

Installation

npm install -g @spines/mcp-server

Konfiguration

Claude Desktop

Füge Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows) hinzu:

{
  "mcpServers": {
    "spines": {
      "command": "npx",
      "args": ["-y", "@spines/mcp-server"],
      "env": {
        "SPINES_API_KEY": "gtspn_live_your_key_here"
      }
    }
  }
}

VS Code / Cursor

Füge Folgendes zu deinen MCP-Einstellungen hinzu:

{
  "spines": {
    "command": "npx",
    "args": ["-y", "@spines/mcp-server"],
    "env": {
      "SPINES_API_KEY": "gtspn_live_your_key_here"
    }
  }
}

Umgebungsvariablen

Variable

Erforderlich

Standard

Beschreibung

SPINES_API_KEY

Ja

-

Dein API-Schlüssel

SPINES_API_URL

Nein

https://spins.app/api/v1

API-Basis-URL

SPINES_DEBUG

Nein

false

Ausführliche Protokollierung auf stderr

Tools

Lese-Tools

Tool

Beschreibung

search_books

Suche nach Büchern nach Titel, Autor oder ISBN

get_book_details

Rufe vollständige Details für ein bestimmtes Buch ab

get_collection

Rufe eine Büchersammlung mit allen ihren Büchern ab

list_collections

Liste deine Sammlungen mit optionalen Filtern auf

list_categories

Liste alle genehmigten Buchkategorien auf

get_persona

Rufe Details zu einer Persona ab

Schreib-Tools

Tool

Beschreibung

add_to_reading_list

Füge ein Buch zu einer Leseliste hinzu

remove_from_reading_list

Entferne ein Buch aus einer Leseliste

Tool-Details

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

Ressourcen

URI

Beschreibung

spines://collection/{id}

Eine Büchersammlung mit Metadaten

spines://book/{id}

Vollständige Buchdetails

spines://persona/{id}

Persona-Profil und Sammlungen

spines://reading-lists

Leselisten des Benutzers

Prompts

Prompt

Beschreibung

analyze_shelf

Analysiere eine Sammlung auf Themen und Lesemuster

recommend_books

Erhalte Empfehlungen basierend auf deiner Bibliothek

compare_collections

Vergleiche zwei Sammlungen auf Ähnlichkeiten

Fehlerbehebung

Problem

Lösung

"SPINES_API_KEY is required"

Setze die Umgebungsvariable in deiner MCP-Client-Konfiguration

401-Fehler

Prüfe, ob dein API-Schlüssel gültig und nicht abgelaufen ist

403-Fehler

Deinem Schlüssel fehlen möglicherweise erforderliche Berechtigungen

429-Fehler

Ratenlimit erreicht – warte und versuche es erneut

Tools werden nicht angezeigt

Starte deinen MCP-Client neu

Entwicklung

git clone https://github.com/GetSpines/mcp-server
cd mcp-server
npm install
npm run build
npm test

Lizenz

MIT

This server cannot be installed

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

How are these scores calculated?

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

  • Readbook MCP Server

    mkafw
    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.

  • apple-books-mcp

    ragmha
    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

  • hardcover-mcp

    kristianedlund
    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

  • CalibreMCP

    sandraschi
    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