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가 필요합니다"

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