SansFiction MCP 与 Agent 技能

将 AI 智能体连接到 SansFiction —— 一个面向图书、合集、阅读日志和发现的数字图书馆。

相同的能力通过两种方式暴露，均使用相同的 bearer token 进行身份验证：

• MCP 服务器（可流式 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 客户端指向上述可流式 HTTP 端点。公共目录工具无需身份验证；个人图书馆工具需要 bearer token（在 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

个人图书馆（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

发现

• Agent 技能：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）

本仓库还附带一个小的 stdio MCP 服务器，代理到托管的 REST API，因此您可以在任何 MCP 客户端期望本地命令的地方运行它：

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

环境变量：

• SANSFICTION_TOKEN —— 个人图书馆工具的 bearer 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 不需要网络或凭据，因此内省检查无需令牌即可通过。