Sansfiction

Gestión de biblioteca y descubrimiento de libros

GitHubPrueba este MCPPatrocinado

Documentación

SansFiction MCP & Agent Skill

sansfiction-mcp MCP server

Conecta agentes de IA a SansFiction — una biblioteca digital para libros, colecciones, diarios de lectura y descubrimiento.

Las mismas capacidades se exponen de dos maneras, ambas autenticadas con el mismo token de portador:

  • Servidor MCP (Streamable HTTP): https://sansfiction.com/api/mcp
  • API REST (v1): https://sansfiction.com/api/v1

Inicio rápido (MCP)

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

O apunta cualquier cliente MCP al endpoint streamable-HTTP de arriba. Las herramientas del catálogo público no requieren autenticación; las herramientas de la biblioteca personal requieren un token de portador (genera uno en sansfiction.com/docs/agents).

Inicio rápido (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"

Capacidades

Catálogo público (sin autenticación)

  • 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

Biblioteca personal (token de portador)

  • 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

Descubrimiento

  • Agent Skill: SKILL.md — también disponible en https://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md
  • Manifiesto del registro MCP: server.json
  • OpenAPI: https://sansfiction.com/openapi.json
  • Tarjeta del servidor MCP: https://sansfiction.com/.well-known/mcp/server-card.json

Autenticación

Genera un token de acceso personal (sf_mcp_…) mientras estás conectado en sansfiction.com/docs/agents. El mismo token autentica tanto el servidor MCP como la API REST. Límites de velocidad: 60 solicitudes/min anónimo, 180 solicitudes/min autenticado.

Licencia

El servicio SansFiction es propietario. Este repositorio documenta su interfaz pública de agente para descubrimiento e integración.

Ejecutar localmente como servidor MCP (stdio)

Este repositorio también incluye un pequeño servidor MCP stdio que actúa como proxy hacia la API REST alojada, para que puedas ejecutarlo en cualquier lugar donde un cliente MCP espere un comando local:

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

Variables de entorno:

  • SANSFICTION_TOKEN — token de portador (sf_mcp_…) para las herramientas de la biblioteca personal (genera uno en https://sansfiction.com/docs/agents). Las herramientas del catálogo público no necesitan ninguno.
  • SANSFICTION_BASE_URL — sobrescribe la base de la API (por defecto https://sansfiction.com).

Herramientas: 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.

Configuración de compilación de Glama

  • Pasos de compilación: ["npm install"]
  • Argumentos de CMD: ["mcp-proxy","--","node","index.js"]

tools/list no requiere red ni credenciales, por lo que la verificación de introspección se completa sin token.