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

Или укажите любой MCP-клиент на конечную точку streamable-HTTP выше. Инструменты публичного каталога не требуют аутентификации; инструменты личной библиотеки требуют токен-носитель (создайте его на 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: server.json

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

• Карточка MCP-сервера: https://sansfiction.com/.well-known/mcp/server-card.json

Аутентификация

Создайте персональный токен доступа (sf_mcp_…) в процессе входа на sansfiction.com/docs/agents. Один и тот же токен аутентифицирует и MCP-сервер, и REST API. Ограничения скорости: 60 запросов/мин анонимно, 180 запросов/мин для аутентифицированных.

Лицензия

Сервис SansFiction является проприетарным. Этот репозиторий документирует его публичный интерфейс агента для обнаружения и интеграции.

Локальный запуск в качестве MCP-сервера (stdio)

Этот репозиторий также включает небольшой stdio MCP-сервер, который проксирует запросы к размещенному REST API, что позволяет запускать его везде, где MCP-клиент ожидает локальную команду:

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

Переменные окружения:

• SANSFICTION_TOKEN — токен-носитель (sf_mcp_…) для инструментов личной библиотеки (создаётся на https://sansfiction.com/docs/agents). Инструменты публичного каталога не требуют токена.

• SANSFICTION_BASE_URL — переопределить базовый URL API (по умолчанию 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 не требует сети или учетных данных, поэтому проверка интроспекции проходит без токена.