mcp-server-fanqie

番茄小说：MCP、独立 Skill 与 DeepSeek Harness 阅读插件

搜索番茄作品、查看小说目录和网站可见正文、读取书评；本人扫码登录后，还可以读取自己的书架、阅读进度和收藏划线原文。

项目提供三种入口：MCP 服务、独立 Skill、DeepSeek Harness 图形插件，另有命令行和本地 HTTP API。各入口复用本机数据核心，直接访问番茄官方站点。

版本说明：MCP / Skill 历史 Release 为 0.2.0-dev.6；DeepSeek Harness 插件为源码中的 0.4.0。旧 Release 不含该插件，应从当前仓库获取插件。

安装与使用 · Harness 插件 · 功能清单 · HTTP API · 历史 Release 当前插件尚未发布到 npm；旧 npm 包 @fysh925/mcp-server-fanqie 也不包含此开发预览版。请使用仓库源码或对应的历史 Release，不要使用旧 npm 包判断当前功能。 三种使用方式 MCP：为支持 MCP 的 AI 客户端提供番茄搜索、阅读和本人账号数据查询。当前开发预览版请按使用指南从源码或 Release 安装。 独立 Skill：在支持 Skill 和 Node.js 22+ 的客户端中使用，技能目录包含独立运行文件。安装方法见使用指南。 DeepSeek Harness 插件：在右侧栏搜索、查看封面和目录、阅读网站可见章节；本人扫码后查看书架和收藏划线，并提供对话工具。详见插件文档。

DeepSeek Harness 插件是独立包 dsh-fanqie-reader；它与上文提到的 MCP 包 @fysh925/mcp-server-fanqie 是不同的 npm 包。插件当前支持的媒体范围和账号使用方式见插件文档。 为什么重做：从第三方服务迁移到本地实现

旧版0.1.x的主要职责是把第三方服务封装成14个MCP工具，默认请求 http://101.35.133.34:5000。搜索、目录、正文和设备管理等能力由该第三方服务器提供。第三方地址不可用后，MCP工具虽然仍能列出，实际查询也会随之失效。

本次把数据获取实现放进项目本身： 本地实现公开查询：搜索、书籍详情、目录、网站可见章节、书评正文，直接访问官方入口。 提供 MCP、独立 Skill 和 Harness 插件：三种入口复用核心；Skill 可以独立运行，Harness 插件提供图形界面和对话工具。 新增本人账号能力：扫码登录、当前书架、云端阅读位置、收藏划线原文及翻页。 补齐使用与错误处理：目录分页、分类搜索游标、完整书评文本、故障重试、限流提示及本地索引后备。 明确能力边界：保留旧路径方便迁移，未实现的功能返回501；不把工具名称还存在当作功能已经完成。

本版解决的是旧第三方API这一中间依赖，仍需要联网访问番茄官方站点。官方接口、网页结构、字体或匿名设备规则变化后，仍可能需要维护。 对比旧第三方服务：本次实现了什么

“旧版范围”以仓库0.1.x的README和API封装为依据，只说明当时声明或转发了什么，不代表现在还可验证旧服务，也不保证新旧返回字段逐项相同。 结论：本版覆盖了公开搜索、书评、小说网站阅读和个人阅读数据的当前需求，并未完整复刻旧服务的音视频、漫画内容、设备池、iOS或整本下载能力。 当前MCP与Skill能调用哪些方法

以下Skill命令均由技能目录内的 scripts/fanqie.mjs 执行。源码用户可使用 node "server/cli.mjs" 。 公开查询，无需账号登录 本人账号，需要扫码授权 辅助与兼容方法 MCP共注册22个工具，其中16个公开查询/本人账号工具、2个状态兼容工具、4个未实现工具。Skill/CLI有19个命令，含help和capabilities。Harness 插件另注册7个 fanqie_* 对话工具，并提供图形界面；它们与 MCP 的22个工具不是一一对应。参数、HTTP路径及边界见 完整清单。 我们如何实现

旧版调用链是“AI客户端 → MCP封装 → 第三方开放API → 数据”。本版默认调用链如下：

数据来源与处理方式 小说公开搜索不需要签名或本人登录。书评与App分类搜索使用匿名设备参数和本地签名，内置公共示例设备可能失效，可配置配套的 FANQIE_DEVICE_ID、FANQIE_INSTALL_ID；不会自动注册设备或激活会员。个人书架和划线使用本人扫码的会话，与匿名设备配置是两条独立链路。 稳定性和数据边界 公开上游请求串行处理，最小间隔500毫秒，同一请求合并；缓存最多100项、有效期5分钟。网络中断或502/503/504最多重试一次，限流时返回等待时间。 个人响应不进入公开查询缓存，按本地账号配置分别存储；同一账号跨进程使用文件锁。账号请求不自动重试。 账号凭据默认在系统用户数据目录，可用 FANQIE_ACCOUNT_DIR 指定；不写入技能目录、源码仓库或发布包。不同系统不保证文件加密，请使用自己的受保护用户目录。 书架是当前书架，阅读进度是官方当前返回的云端记录；缺少进度不能推断从未读过。read_progress不直接当作百分比。 只有 has_more=false 才结束划线翻页。上游分页同时计算书签等记录，某页没有划线也可能还有下一页。 HTTP API仅监听本机，拒绝浏览器Origin及非本机Host，可选Bearer Token；账号接口不面向公开部署或多租户服务。 安装：选择适合的入口 DeepSeek Harness：图形界面与对话工具