SansFiction MCP & Agent Skill

AI 에이전트를 SansFiction에 연결하세요 — 책, 컬렉션, 독서 일지, 발견을 위한 디지털 라이브러리입니다.

동일한 기능이 두 가지 방식으로 제공되며, 두 방식 모두 동일한 베어러 토큰으로 인증됩니다.

• MCP 서버 (Streamable HTTP): https://sansfiction.com/api/mcp

• REST API (v1): https://sansfiction.com/api/v1

빠른 시작 (MCP)

claude mcp add --transport http sansfiction https://sansfiction.com/api/mcp

또는 위의 streamable-HTTP 엔드포인트를 MCP 클라이언트에 지정하세요. 공개 카탈로그 도구는 인증이 필요 없지만, 개인 라이브러리 도구는 베어러 토큰이 필요합니다 (sansfiction.com/docs/agents에서 생성).

Related MCP server: Calibre RAG MCP Server

빠른 시작 (REST)

# Public catalog — no auth
curl "https://sansfiction.com/api/v1/catalog/search?q=dune&limit=5"

# Personal library — bearer token
curl -H "Authorization: Bearer $SF_TOKEN" \
  "https://sansfiction.com/api/v1/library/books?status=reading"

기능

공개 카탈로그 (인증 불필요)

• GET /api/v1/catalog/search?q=…&searchType=all|author|series|mood|isbn

• GET /api/v1/catalog/books/{bookId}

• GET /api/v1/catalog/series/{seriesId}

• GET /api/v1/catalog/collections

개인 라이브러리 (베어러 토큰)

• GET/POST /api/v1/library/books · PATCH/DELETE /api/v1/library/books/{bookId}

• GET /api/v1/library/search

• GET /api/v1/library/collections · GET /api/v1/library/collections/{id} · POST …/items

• GET /api/v1/library/stats

검색

• Agent Skill: SKILL.md — 또한 https://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md에서 제공됩니다.

• MCP Registry manifest: server.json

• OpenAPI: https://sansfiction.com/openapi.json

• MCP server card: https://sansfiction.com/.well-known/mcp/server-card.json

인증

로그인한 상태에서 sansfiction.com/docs/agents에서 개인 액세스 토큰(sf_mcp_…)을 생성하세요. 동일한 토큰이 MCP 서버와 REST API 모두를 인증합니다. 속도 제한: 익명 60회/분, 인증 180회/분.

라이선스

SansFiction 서비스는 독점 소프트웨어입니다. 이 저장소는 검색 및 통합을 위한 공개 에이전트 인터페이스를 문서화합니다.

로컬에서 MCP 서버로 실행 (stdio)

이 저장소에는 호스팅된 REST API에 프록시 역할을 하는 작은 stdio MCP 서버도 포함되어 있어, MCP 클라이언트가 로컬 명령을 기대하는 모든 곳에서 실행할 수 있습니다.

npx sansfiction-mcp
# or
npm install && node index.js

환경 변수:

• SANSFICTION_TOKEN — 개인 라이브러리 도구용 베어러 토큰 (sf_mcp_…) (https://sansfiction.com/docs/agents에서 생성). 공개 카탈로그 도구는 필요 없음.

• SANSFICTION_BASE_URL — API 기본 URL 재정의 (기본값 https://sansfiction.com).

도구: search_books, get_book, get_series, list_public_collections, list_my_books, add_book_to_library, update_library_book, remove_book_from_library, search_my_library, list_my_collections, get_reading_stats.

Glama 빌드 구성

• 빌드 단계: ["npm install"]

• CMD 인수: ["mcp-proxy","--","node","index.js"]

tools/list는 네트워크나 자격 증명이 필요하지 않으므로 토큰 없이도 인트로스펙션 검사를 통과합니다.