Skip to main content
Glama
deenesjakoruzh
GetSpines

SPINES MCP Server

Official
by GetSpines
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

SPINES MCP Server

Доступ к коллекциям книг, спискам чтения и данным книжной полки SPINES из ИИ-ассистентов через Model Context Protocol.

Возможности

  • Поиск книг по названию, автору или ISBN

  • Просмотр и фильтрация коллекций книг

  • Управление списками чтения (добавление и удаление книг)

  • Изучение персон и категорий

  • ИИ-подсказки для анализа полки и рекомендаций книг

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

Базовый URL API

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

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