Skip to main content
Glama
deenesjakoruzh
GetSpines

SPINES MCP Server

Official
by GetSpines
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

SPINES MCP Server

Accede a las colecciones de libros, listas de lectura y datos de estantería de SPINES desde asistentes de IA mediante el Model Context Protocol.

Características

  • Buscar libros por título, autor o ISBN

  • Explorar y filtrar colecciones de libros

  • Gestionar listas de lectura (añadir y quitar libros)

  • Explorar personas y categorías

  • Indicaciones de IA para análisis de estanterías y recomendaciones de libros

Related MCP server: apple-books-mcp

Inicio rápido

Requisitos previos

Instalación

npm install -g @spines/mcp-server

Configuración

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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

Añade a tu configuración de MCP:

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

Variables de entorno

Variable

Requerida

Por defecto

Descripción

SPINES_API_KEY

Sí

-

Tu clave de API

SPINES_API_URL

No

https://spins.app/api/v1

URL base de la API

SPINES_DEBUG

No

false

Registro detallado en stderr

Herramientas

Herramientas de lectura

Herramienta

Descripción

search_books

Buscar libros por título, autor o ISBN

get_book_details

Obtener detalles completos de un libro específico

get_collection

Obtener una colección de libros con todos sus libros

list_collections

Listar tus colecciones con filtros opcionales

list_categories

Listar todas las categorías de libros aprobadas

get_persona

Obtener detalles sobre una persona

Herramientas de escritura

Herramienta

Descripción

add_to_reading_list

Añadir un libro a una lista de lectura

remove_from_reading_list

Quitar un libro de una lista de lectura

Detalles de las herramientas

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

Recursos

URI

Descripción

spines://collection/{id}

Una colección de libros con metadatos

spines://book/{id}

Detalles completos del libro

spines://persona/{id}

Perfil de persona y colecciones

spines://reading-lists

Listas de lectura del usuario

Indicaciones

Indicación

Descripción

analyze_shelf

Analizar una colección para identificar temas y patrones de lectura

recommend_books

Obtener recomendaciones basadas en tu biblioteca

compare_collections

Comparar dos colecciones para encontrar similitudes

Solución de problemas

Problema

Solución

"SPINES_API_KEY is required"

Establece la variable de entorno en la configuración de tu cliente MCP

Errores 401

Comprueba que tu clave de API es válida y no ha caducado

Errores 403

Tu clave puede carecer de los ámbitos necesarios

Errores 429

Límite de velocidad: espera y reintenta

Las herramientas no aparecen

Reinicia tu cliente MCP

Desarrollo

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

Licencia

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