NOVELCATCH / MCP
让自己的 AI 查询本站数据
用你自己账号的个人 token,让 AI 帮你找书、比较与跟进收藏,不用在网页里反复筛选。
接入客户端:Codex、WorkBuddy、豆包工作、ZCode、Qoder CN。
01生成 token
token 生成即将开放,上线后会在更新日志里通知。
02配置客户端
连接地址:https://novelcatch.com/api/mcp
Codex CLI · 从终端启动
在自己的终端设置本会话环境变量,再添加服务。变量的值就是你创建的 token,不要加 Bearer 前缀。
本会话环境变量
export NOVELCATCH_MCP_TOKEN='<你的token>'Codex CLI 命令
codex mcp add novelcatch --url https://novelcatch.com/api/mcp --bearer-token-env-var NOVELCATCH_MCP_TOKEN等价 TOML 配置
环境变量 TOML
[mcp_servers.novelcatch]
url = "https://novelcatch.com/api/mcp"
bearer_token_env_var = "NOVELCATCH_MCP_TOKEN"CLI 可用 /mcp 查看连接状态。只通过连接配置提供 token,不要贴到 AI 对话或提交到 git;也别把含真实 token 的命令留在共享终端历史里。
Codex desktop · 从桌面启动
与同一台电脑上的 CLI 共用 ~/.codex/config.toml,修改后重启客户端。通过 Finder 启动时,不保证继承终端的 export。
桌面端也可以把 token 直接写进本地配置,替换下方的占位文字。它会把 token 明文保存在你的本地配置文件里,请妥善保管该文件,不上传或共享。与上面的环境变量方案二选一,已有 NovelCatch 配置时替换对应段,不重复添加。
桌面端本地 TOML
[mcp_servers.novelcatch]
url = "https://novelcatch.com/api/mcp"
http_headers = { Authorization = "Bearer <你的token>" }03试一句需求
- “找几本我关注分类近期表现较好的书,并说明数据日期”
- “看看我收藏的书今天有什么变化”
- “先确认本站指标定义,再比较这两本书”
让 AI 保留数据日期与口径;陈旧数据、缺测都不等于 0,推断也不代表官方结论。
可查询什么
首批支持 7 个工具,即将支持更多。
- find_books
- 按分类、题材与近期表现找书,缩小对标范围。
- get_books
- 比较指定书籍;单次最多 20 本,可选 summary 摘要或 full 详情。
- get_rank
- 查看官方榜单前 30 名,判断当前分类表现。
- get_debut_books
- 查看首秀书籍与表现,需具备网站对应授权;首秀与相关结论为推断。
- get_my_books
- 查看自己的收藏与常用视图,跟进关注的书。
- get_topic_overview
- 了解题材概况,辅助开题与选题比较。
- get_glossary
- 确认指标定义,理解数据口径。
遇到问题
- 401 / token 失效:重新生成,并更新客户端配置。
- 403 / 授权不足:确认账号是否具备网站对应权限。
- 429:当天额度用尽时,按网站规则等待重置;若是请求太频繁,降低频率并稍后重试。
- busy / 503:按返回的重试等待时间(retry_after)稍后再试。
- 工具不可见:检查 server 是否启用、是否已给当前 assistant 选择 NovelCatch,以及模型是否支持 tool calls。
- 数据不新或没有值:先看数据日期与缺测说明,不把缺测当作 0。