番茄小说MCP

安装：选择MCP或Skill

MCP：从源码或源码ZIP安装

git clone https://github.com/fysh1010/mcp-server-fanqie.git
cd mcp-server-fanqie
npm ci
npm run build

也可从Release下载源码ZIP，解压后在仓库根目录执行 npm ci 和 npm run build。

支持mcpServers格式的客户端可使用以下JSON配置；其他客户端按其MCP配置格式填写相同command和args：

{
  "mcpServers": {
    "fanqie": {
      "command": "node",
      "args": ["D:/你的路径/mcp-server-fanqie/server/mcp-local.mjs"]
    }
  }
}

将args改为本机真实绝对路径。macOS/Linux填写对应的 /Users/... 或 /home/... 路径。若客户端找不到node，将command改为Node可执行文件的绝对路径。重新加载MCP连接后即可搜书，无需先运行 start:api。

Release也提供本地npm安装用的 .tgz；安装步骤见 使用指南。不要把旧npm包名的npx配置当作本版安装方法，也不要将本机路径填写到无法访问本机文件的云端托管环境。

使用：可以直接告诉AI什么

番茄小说：MCP、独立 Skill 与本地 API

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

当前版本：0.2.0-dev.6，GitHub开发预览版。 默认使用本机运行的数据核心，直接请求番茄官方站点，已取消对旧第三方开放API的默认依赖。独立Skill包含全部必需运行代码，只需要Node.js 22+和网络；MCP需要安装项目依赖。

下载本版 · 详细安装与使用 · 全部方法清单 · HTTP接口文档

本版发布到GitHub，未发布npm registry。不要用旧说明中的 npx -y @fysh925/mcp-server-fanqie 安装方式判断本版能力：registry里的旧包仍是旧架构。请使用本仓库源码或本版Release附件。

当前MCP与Skill能调用哪些方法

以下Skill命令均由技能目录内的 scripts/fanqie.mjs 执行。源码用户可使用 node "server/cli.mjs" <命令>。

辅助与兼容方法

MCP共注册22个工具，其中16个公开查询/本人账号工具、2个状态兼容工具、4个未实现工具。Skill/CLI有19个命令，含help和capabilities。参数、HTTP路径及边界见 完整清单。

独立HTTP API

npm run start:api

默认地址为 http://127.0.0.1:5000。示例：

Invoke-RestMethod "http://127.0.0.1:5000/health"
Invoke-RestMethod "http://127.0.0.1:5000/api/search?key=三体"
Invoke-RestMethod "http://127.0.0.1:5000/api/account/status?account=default"

成功返回 { "code": 200, "message": "success", "data": ... }，失败同时使用真实HTTP状态码及业务码。接口清单、参数、Token和端口配置见 HTTP文档。

对比旧第三方服务：本次实现了什么

“旧版范围”以仓库0.1.x的README和API封装为依据，只说明当时声明或转发了什么，不代表现在还可验证旧服务，也不保证新旧返回字段逐项相同。

结论：本版覆盖了公开搜索、书评、小说网站阅读和个人阅读数据的当前需求，并未完整复刻旧服务的音视频、漫画内容、设备池、iOS或整本下载能力。