Sansfiction

Gerenciamento de biblioteca e descoberta de livros

GitHubExperimente este MCPPatrocinado

Documentação

SansFiction MCP & Agent Skill

sansfiction-mcp MCP server

Conecte agentes de IA ao SansFiction — uma biblioteca digital para livros, coleções, diários de leitura e descoberta.

As mesmas capacidades são expostas de duas formas, ambas autenticadas com o mesmo bearer token:

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

Início rápido (MCP)

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

Ou aponte qualquer cliente MCP para o endpoint streamable-HTTP acima. Ferramentas do catálogo público não exigem autenticação; ferramentas da biblioteca pessoal exigem um bearer token (gere um em sansfiction.com/docs/agents).

Início 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 (sem autenticação)

  • 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 pessoal (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

Descoberta

  • Agent Skill: SKILL.md — também disponível em https://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md
  • Manifesto do MCP Registry: server.json
  • OpenAPI: https://sansfiction.com/openapi.json
  • Cartão do servidor MCP: https://sansfiction.com/.well-known/mcp/server-card.json

Autenticação

Gere um token de acesso pessoal (sf_mcp_…) enquanto estiver conectado em sansfiction.com/docs/agents. O mesmo token autentica tanto o servidor MCP quanto a API REST. Limites de taxa: 60 req/min anônimo, 180 req/min autenticado.

Licença

O serviço SansFiction é proprietário. Este repositório documenta sua interface pública de agente para descoberta e integração.

Executar localmente como servidor MCP (stdio)

Este repositório também inclui um pequeno servidor MCP stdio que faz proxy para a API REST hospedada, para que você possa executá-lo em qualquer lugar onde um cliente MCP espere um comando local:

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

Variáveis de ambiente:

  • SANSFICTION_TOKEN — bearer token (sf_mcp_…) para as ferramentas da biblioteca pessoal (gere em https://sansfiction.com/docs/agents). Ferramentas do catálogo público não precisam de nenhum.
  • SANSFICTION_BASE_URL — substitui a base da API (padrão https://sansfiction.com).

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

Configuração de build do Glama

  • Etapas de build: ["npm install"]
  • Argumentos CMD: ["mcp-proxy","--","node","index.js"]

tools/list não requer rede nem credenciais, então a verificação de introspecção passa sem token.