SPINES MCP Server
OfficialSPINES MCP Server
AI 어시스턴트에서 SPINES 도서 컬렉션, 읽기 목록 및 책장 데이터에 Model Context Protocol을 통해 접근하세요.
기능
제목, 저자 또는 ISBN으로 책 검색
도서 컬렉션 탐색 및 필터링
읽기 목록 관리 (책 추가 및 제거)
페르소나 및 카테고리 탐색
책장 분석 및 도서 추천을 위한 AI 프롬프트
Related MCP server: apple-books-mcp
빠른 시작
사전 요구 사항
Node.js 18+
SPINES API 키 (여기에서 받기)
설치
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"
}
}
}환경 변수
변수 | 필수 | 기본값 | 설명 |
| 예 | - | 귀하의 API 키 |
| 아니요 |
| API 기본 URL |
| 아니요 |
| stderr로 상세 로깅 |
도구
읽기 도구
도구 | 설명 |
| 제목, 저자 또는 ISBN으로 책 검색 |
| 특정 책의 전체 세부 정보 가져오기 |
| 모든 책이 포함된 도서 컬렉션 가져오기 |
| 선택적 필터로 컬렉션 나열 |
| 승인된 모든 도서 카테고리 나열 |
| 페르소나에 대한 세부 정보 가져오기 |
쓰기 도구
도구 | 설명 |
| 읽기 목록에 책 추가 |
| 읽기 목록에서 책 제거 |
도구 세부 정보
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 IDget_collection
collection_id: string - The collection's unique IDlist_collections
limit?: number - Max results (1-50, default 20)
cursor?: string - Pagination cursor
persona_id?: string - Filter by persona
category_id?: string - Filter by categoryadd_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_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
This server cannot be installed
Maintenance
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
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to help users manage their reading experience by searching books, tracking reading progress, managing bookmarks, and generating personalized recommendations and summaries.
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseAqualityAmaintenanceConnects AI assistants to the Hardcover book library, enabling natural language book searches, reading status updates, list management, and library exploration.315MIT
- AlicenseNot gradedqualityBmaintenanceBridges your Calibre e-book library with AI assistants via the Model Context Protocol, enabling natural-language library management, semantic search, RAG, and agentic workflows.39MIT
Related MCP Connectors
Federated search of books and papers, BibTeX/RIS citations, open-access retrieval and reading.
Search books and authors, fetch editions, browse subjects, and resolve cover images.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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