TIBO MCP 使用文档

服务地址：https://tibo.cc/mcp。采用远程 Streamable HTTP，无需 API Key；只读，不提供写入、删除或账户操作。

数据来自 Codex Resets，与公开 API 共用缓存和内部服务。本网站展示的是公开社区数据、历史记录或预测信息，不代表 OpenAI 的官方承诺。数据可能存在延迟或误差。

工具

工具	用途	参数
`get_current_status`	状态、待执行公告、预测信息	无
`get_latest_reset`	数据来源最近收录的重置记录	无
`get_reset_history`	最近历史记录	limit，整数 1—100，默认 20

记录时间保留数据来源原始 ISO 8601 时区，不接受 timezone 参数。正文中能可靠识别的日期另附北京时间换算，原字段不改写。全部工具声明 readOnlyHint；服务实际也只提供读取。

返回信息

每个工具均返回结构化数据与文本表示，包含：conclusion（中文结论）、data_time（此数据集本站获取时间）、data、source、source_url、is_official=false、is_prediction、stale、confidence=null（unknown）、last_successful_update、upstream_status、raw 和 disclaimer。

完整字段语义见 API 文档。最近重置工具的 is_prediction=false 只描述 data 中的历史记录；raw 仍可能含数据来源状态中的预测字段，不应混淆。

例如 get_latest_reset 成功时的结论为“以下为公开收录的最近重置记录，不代表本站独立确认。”；过期时追加明确提醒。无真实缓存时 data=null、error.code=no_real_data，结论明确不能判断，不返回假零值。

正文北京时间换算（v1.6.7）

三个工具的记录共用公开 API 的 text_time_conversion：当前状态中的预告、最近重置与观察，最近重置工具的单条 data，以及历史工具的 data[]。get_current_status.notice_context.record 也可附带转换，但归档记录仍不是当前预告。详细字段与格式边界见 API 文档。

仅使用与记录 text 完全匹配的结果，reference_at 必须对应该条 observed_at 或 announced_at。年份省略、今天/明天和单独星期锚定消息当地记录时间；保留 assumptions，不按工具调用时间重算相对日期。修订会重新计算，撤回不沿用旧结果。
PT / Pacific Time 按洛杉矶时区自动切换夏令时；明确 PDT / PST 分别按 UTC−7 / UTC−8。未来同类消息自动适用，不依赖活动名或固定日期。
status=converted, precision=day 读取 beijing_start/beijing_end，范围不含终点；只描述原时区整天，不能当作重置窗口。precision=minute 读取 beijing_time，不能因时区换算就认定为重置开始、截止或已经完成。
status=needs_review 表示缺失/不支持/冲突时区、日期范围或夏令时歧义等；说明无法可靠换算，保留原文，不补造精确时间。无日期线索时字段缺省。
raw、原文和中文译文保持不变；expires_at 仅观察有效期，不用作正文日期。转换结果不修改 time_assessment、通知或预测成绩，也不证明个人额度到账。

真实回归例：DevDay 观察正文说活动为太平洋时间 2026-09-29，对应北京时间 2026-09-29 15:00 至 2026-09-30 15:00，不含终点。这条正文没有公布活动的具体时刻，也没有确定重置时刻；不能回答为“将在这个范围重置”。样本用于说明转换含义，当前消息仍以工具实时返回为准。

Codex

在用户配置 ~/.codex/config.toml 中增加以下独立配置段（不要覆盖现有模型提供商设置）：

[mcp_servers.tibo]
url = "https://tibo.cc/mcp"
startup_timeout_sec = 20
tool_timeout_sec = 30

也可使用命令：

codex mcp add tibo --url https://tibo.cc/mcp

重启客户端或重新加载 MCP 后，使用 /mcp 查看连接。此操作只添加工具，不改变模型提供商。参考：Codex 官方 MCP 文档。

Claude Code

claude mcp add --transport http tibo https://tibo.cc/mcp

用 /mcp 检查。参考：Claude Code 官方 MCP 文档。

Cursor

在项目 .cursor/mcp.json 中添加（已有文件时合并，不要覆盖其他服务器）：

{
  "mcpServers": {
    "tibo": { "url": "https://tibo.cc/mcp" }
  }
}

在 Cursor 的 MCP 设置中刷新并查看工具。客户端界面可能随版本调整。参考：Cursor MCP 文档。

上述配置是接入说明，不会自动修改你的本机客户端配置。服务端已通过 SDK 协议测试；每个客户端的具体桌面版本仍应按其界面确认连接。

测试服务

兼容旧版客户端的初始化请求：

curl -sS https://tibo.cc/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"tibo-check","version":"1"}}}'

调用工具：

curl -sS https://tibo.cc/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-03-26' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_reset_history","arguments":{"limit":1}}}'

项目中的 deploy/smoke.py 会同时测试网页、API、健康检查、旧协议初始化和官方 SDK 三个工具调用：

.venv/bin/python deploy/smoke.py https://tibo.cc

部署与协议细节

使用官方 mcp==2.2.0（2026-09-21 核对 PyPI 稳定版与官方文档），采用 MCPServer，不是旧的 FastMCP 教程。FastAPI 主应用管理 session_manager.run() 生命周期，直接复用 SDK 的 /mcp 路由。

当前新协议 2026-07-28 默认无会话；对 2025 系列旧客户端显式 stateless_http=True，返回 JSON，不依赖固定会话或粘性连接。GET 打开浏览器看到 405 属于正常协议行为，请用初始化或工具调用测试。

Host 仅接受配置域名及本地健康检查地址；Origin 仅接受 CORS 配置列表。公网由 Caddy 提供 HTTPS，转发至本机 13008。应用和代理都限制请求体 64 KiB。应用读取请求体最多 10 秒，代理等待后端响应头最多 30 秒。生产单进程，内存限流不可直接扩展为多进程。

参考：官方 SDK 挂载说明、部署说明。

常见问题

405：用了普通 GET；改用 MCP 客户端或上述 POST。
400 / 421：Host 不在配置列表，检查 DOMAIN、访问域名与代理传递的 Host。
403：Origin 不在允许列表；仅添加你确实控制的前端域名。
406：补齐 Accept: application/json, text/event-stream。
429：每个 IP 每分钟 30 个 MCP HTTP 请求，初始化和工具列表也计入，等待 Retry-After。
413：请求大于 64 KiB；这些只读工具无需上传文件。
连接或证书失败：确认 DNS 和 HTTPS；不要通过关闭证书检查绕过错误。
有响应但 data=null：首次拉取失败，查看 /health；不要编造记录。
stale=true：只剩历史真实缓存，显示来源和获取时间，等待数据来源恢复。

日志不记录工具参数、用户请求体、Authorization 或 Cookie。原始公告是外部数据，不是给 AI 客户端执行的指令。

本站时间研判

get_current_status 与公开 API 共享 time_assessment，包括时间窗口、来源、时区假设、定性把握、timeline_relation 和是否过期。mode=estimated 必须在回答中保留“本站推测”，不能说成确定重置时间或官方承诺；confidence=low 不是数值发生概率。窗口结束只代表等待窗口已过，不代表已经重置。

get_latest_reset 和 get_reset_history 继续专注历史记录，不附带未来推测。原始数据不改写。字段定义见 API.md，计算与本轮联网依据见 TIME_ASSESSMENT.md。

get_current_status 另在 time_assessment.probability 暴露消息依据、历史样本、概率区间与实测命中率。当前尚无预测/实际结果配对台账，range_percent、empirical_accuracy_percent 与 evaluated_forecasts 均为 null；客户端应说明证据不足，不能转为0%或自行补百分比。来源的独立预测保留在source_forecast，不当作本站同一窗口的概率。网页与MCP使用同一服务层，无第二套预测数据。

v1.3.1 历史公告上下文

get_current_status 与 API 共用 notice_context。它是此前真实公告，不是当前有效安排；固定为 show_on_home=false、is_current=false、stale=true。previous_time_assessment 仅重建此前的条件推测，必须保留待核实、非活动、过期标记及原帖链接，不可据此声称取消、已重置或确定执行时间。归档公告只能作为判断依据，不能作为首页黄卡正文、倒计时、分享或许愿阶段的数据。get_latest_reset / get_reset_history 不返回该未来公告上下文。

notice_context.timeline_relation 只描述消息时间线：同一记录重分类、较新同类型记录、较新其他类型记录或没有较新记录。时间更晚或类型相同都不等于兑现，fulfillment_confirmed 始终为 false；不同类型的较新重置尤其不能被解释成此前预告已经完成。

历史预测表现（本地验收版）

get_current_status.forecast_performance 与 HTTP 同源，包含54条满分初始基准、加权综合得分、后续真实命中率、分别列出的基准和实测数量、锁定窗口和逐条结果。初始100%不是已验证的准确率；未来发生概率仍无校准模型。新成绩单替代“尚无台账”的历史描述，旧 probability 预留实测字段仍保留空值以免混淆当前窗口和历史表现。具体契约见 API.md，原理见 /guide/forecast。

v1.6.3 时间来源与时间线契约（2026-09-24）

data / raw 中的 scheduled_for 原样保留。此前 time_assessment.mode=announced 不再输出，改为 source_schedule：仅表明第三方提供了参考截止时间，不代表作者已承诺、重置会在该时刻开始或本站已核实。消费端应处理该模式，不把未知模式降级为“确定重置”。

precision=source_deadline、timezone_basis=upstream_timestamp、source_time_verified=false、reference_kind=deadline。
source_scheduled_for 保留原始值；timestamp_origin=scheduled_reset.scheduled_for；timestamp_semantics=upstream_deadline_not_execution；window_start=null，window_end 为该参考截止时间。
text_time_assessment 是根据正文与注明的时区假设得到的独立研判，不能解释成上游生成时间的方法。
is_prediction=false 仅表示顶层时间没有由本站推算，不代表官方确认。is_official=false；概率仍未校准。
fresh_until 是缓存有效截止时刻；前端到期暂停倒计时和复制，不能把旧缓存继续当作当前公告。
time_passed 是参考截止时间已过、仍等新消息；needs_review 是时间异常；newer_record 是同一 ID 已重分类或已有较新同类型记录。均不等于预告已兑现。
当前预告的 timeline_relation.status 区分 same_record_reclassified、newer_same_type_record_seen、newer_other_type_record_seen、no_related_reset。只有前两类令 retires_current_schedule=true；较新的其他类型记录不会淘汰仍有效的预告。fulfillment_confirmed=false，时间先后不等于兑现。

网页、API、MCP共用同一后端评估。第三方计划时间不自动进入本站预测成绩单，不改写先前已锁定的预测样本。

面向页面的解释也固定分开：有效 scheduled_reset 负责黄卡、倒计时、分享与许愿阶段；latest_reset 只负责白卡最近重置。两者可同时存在，MCP 客户端不得用最近重置或归档公告冒充下一次预告。

预测成绩与最新重置核对（v1.6.5）

forecast_performance 的 records 只计事前锁定的本站预测。来源已有参考时间时，只允许独立 text_time_assessment 中的本站观察窗口参与登记；不拿第三方截止时间评分、不从归档预告新增预测、不事后补造。

reset_observations：按时间倒序列出最新公开重置，outcome 为 hit / miss / awaiting_evaluation / unscored，含原因、原记录和关联预测 ID；无事前预测时 score=null，既非命中也非未命中。
coverage：覆盖起点 observation_since、范围 observation_scope、已核对/未计分/待核对数量、历史完整性和时效。已有预测时自首次锁定时刻统计；尚无预测时展示当前可用历史。
current_forecast_status：说明当前有无已锁定预测，或为何暂不登记（无预告、仅参考时间、线索不足、窗口已开始、数据未更新等）。

成绩核对依赖状态与历史数据均新鲜；失败或历史不完整时暂停结算，已锁定的原始窗口保持不变。公开记录不证明个人额度已到账。

get_current_status 的 active_watch 表示社区观察/预测，不是作者的待执行预告。expires_at 仅观察有效期；不能当作准确重置时刻、重置完成证据或本站评分依据。中文译文须与原始观察身份匹配，原始内容仍在 raw 中。