SansFiction MCP とエージェントスキル

AIエージェントを SansFiction に接続します — 本、コレクション、読書ジャーナル、発見のためのデジタルライブラリです。

同じ機能は2つの方法で公開されており、どちらも同じベアラートークンで認証されます:

• 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

ディスカバリー

• エージェントスキル: SKILL.md — 以下でも提供されています https://sansfiction.com/.well-known/agent-skills/sansfiction-catalog/SKILL.md

• MCPレジストリマニフェスト: server.json

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

• MCPサーバーカード: 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ベースの上書き（デフォルト 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 はネットワークや認証情報を必要としないため、トークンなしでイントロスペクションチェックが通過します。