SansFiction MCP & Agent Skill

Verbinden Sie KI-Agenten mit SansFiction – einer digitalen Bibliothek für Bücher, Sammlungen, Lesetagebücher und Entdeckungen.

Die gleichen Funktionen werden auf zwei Arten bereitgestellt, beide mit demselben Bearer-Token authentifiziert:

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

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

Schnellstart (MCP)

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

Oder richten Sie einen beliebigen MCP-Client an den obigen Streamable-HTTP-Endpunkt. Öffentliche Katalog-Tools benötigen keine Authentifizierung; persönliche Bibliothekstools erfordern ein Bearer-Token (generieren Sie eines unter sansfiction.com/docs/agents).

Related MCP server: Calibre RAG MCP Server

Schnellstart (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"

Funktionen

Öffentlicher Katalog (keine Authentifizierung)

• 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

Persönliche Bibliothek (Bearer-Token)

• 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

Entdeckung

• Agent Skill: SKILL.md – ebenfalls bereitgestellt unter 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

Authentifizierung

Generieren Sie ein persönliches Zugriffstoken (sf_mcp_…) während Sie unter sansfiction.com/docs/agents angemeldet sind. Dasselbe Token authentifiziert sowohl den MCP-Server als auch die REST-API. Ratengrenzen: 60 req/min anonym, 180 req/min authentifiziert.

Lizenz

Der SansFiction-Dienst ist proprietär. Dieses Repository dokumentiert seine öffentliche Agentenschnittstelle für Entdeckung und Integration.

Lokal als MCP-Server ausführen (stdio)

Dieses Repository enthält auch einen kleinen stdio-MCP-Server, der als Proxy zur gehosteten REST-API dient, sodass Sie ihn überall dort ausführen können, wo ein MCP-Client einen lokalen Befehl erwartet:

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

Umgebungsvariablen:

• SANSFICTION_TOKEN — Bearer-Token (sf_mcp_…) für die persönlichen Bibliothekswerkzeuge (generieren Sie unter https://sansfiction.com/docs/agents). Öffentliche Katalogwerkzeuge benötigen keines.

• SANSFICTION_BASE_URL — überschreibt die API-Basis (Standard https://sansfiction.com).

Tools: 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-Build-Konfiguration

• Build-Schritte: ["npm install"]

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

tools/list benötigt keine Netzwerk- oder Anmeldeinformationen, daher besteht die Introspection-Prüfung ohne Token.