接入 MCP

给 AI 用的中国实时数据层

模型编不出来的三件事:天气、IP 归属地、实时热搜。这三种数据每小时都在变,只能查接口。这里同时提供 REST 与 MCP 两种通道,免密钥、国内节点直连,一行配置就能让 Claude、Cursor、Cline 查到真实数据。

Streamable HTTP:https://mcp.supubao.com/mcp · SSE:https://mcp.supubao.com/mcp/sse

三个数据接口

天气查询

实况 + 未来 7 天预报,覆盖全国城市。

GET /api/v1/tool/weather?city=洛阳&days=3

返回 current(温度/体感/湿度/风速/天气)与 daily 数组;缓存 15 分钟。

IP 归属地

国家、省市、运营商与 ASN,IPv4/IPv6 均可。

GET /api/v1/tool/ip?ip=8.8.8.8

主备双源自动切换;结果按 IP 缓存 6 小时。

全网热搜

微博 / 知乎 / 百度实时榜单,取前 20 条。

GET /api/v1/tool/hot?source=weibo&limit=20

抓取公开榜单页并归一化;缓存 15 分钟。

统一返回结构:{"code":0,"message":"ok","data":{...},"request_id":"..."},code=0 为成功。完整字段与错误码见 数据接口文档。

一行配置接进 AI 客户端

不需要 API Key、不需要装 Node 包、不需要配环境变量。Claude Desktop、Cursor 支持 HTTP 传输,把下面这段放进 mcpServers 即可。

{
  "mcpServers": {
    "supubao": {
      "type": "http",
      "url": "https://mcp.supubao.com/mcp"
    }
  }
}

只支持 SSE 的客户端(Cherry Studio 等)改用 https://mcp.supubao.com/mcp/sse。服务共暴露 36 个工具,其中这三个数据工具是模型自己答不出来的部分。

和常见做法比,差在哪

方案要密钥国内直连一次性覆盖三类数据
国际天气 API(如 OpenWeather)要常需代理否
IP 库服务(如 ip-api)免费版限速一般否
自己写爬虫抓热搜不要,但要维护是否
本服务不要是是(REST + MCP)

取舍也要说清楚:本服务的上游目前是免费额度,稳定性不如付费源;数据粒度是城市级天气与前 20 条热搜,不做分钟级与全量榜。要更细的粒度建议直接接付费源。

缓存、降级与可观测

数据类接口不是每次都打上游:命中缓存直接返回,落盘到本地 SQLite,进程重启后仍可用。

接口缓存 TTL过期兜底上限落盘
weather15 分钟1 小时是
hot15 分钟30 分钟是
ip6 小时24 小时是

运行状态可查:GET /api/v1/stats/upstream?hours=24 返回每个工具的调用量、失败率、平均与最大耗时,以及缓存命中数与已落盘的适配器清单。降级时响应里会出现 _cache: {"stale": true, "age": 秒数},调用方可以据此提示用户数据不是最新的。

这些 TTL 与源选择不是拍的:各公开数据源的横向实测(状态码与耗时原始数据)里记录了为什么选 pconline 做国内 IP 主源、为什么删掉 ip-api 与 ipapi.co。

数据来源与使用边界

常见问题

需要申请 API Key 吗?
不需要。匿名按 IP 每天 10 次基础额度,注册后 50 次,签到与邀请还能换额度。

为什么这三类必须调接口?
模型知识有截止日期,也感知不到当下。天气逐小时变、IP 归属地依赖实时库、热搜每小时变。

上游挂了怎么办?
返回最近一次成功数据并标记 _cache.stale,不静默冒充新数据。

缓存多久更新?
天气与热搜 15 分钟,IP 6 小时。

能商用吗?
当前上游为免费额度,商用需先换授权源;本服务已把数据源集中在适配层,替换成本低。

下一步:接口文档(参数与错误码) · MCP 接入说明 · 额度与积分