用 MCP + 本机 HTTP 搭一条无人值守的数据简报交付链路
背景
很多人的定时任务是这样的:每天早上六点,脚本在服务器上跑完,输出一份统计结果,然后……就没有然后了。结果只停在日志里或者对话框里,要人主动去看。真正想要的是:跑完自己生成一份好看的日报,直接推到你手机上。
这两天我把自己的一个每日任务接上了 MCP 交付平台,走通了「定时任务 → 生成自包含 H5 → 远程 MCP 交付 → 消息通知」这条链路。下面记录几个关键点,都是实打实踩出来的。
一、远程 MCP 的接入姿势
服务端给的是 streamable HTTP 的 MCP 端点,认证放在请求头里:
POST https://<host>/mcp
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-11-25
两个容易挂的地方:
- 协议版本头。握手时服务端会协商出 protocolVersion,之后的 tools/call 必须带上
MCP-Protocol-Version,否则直接报unsupported_protocol。用官方 SDK 会自动带,手写请求很容易忘。 - User-Agent。用 Python urllib 直连时被 403 挡了一次,加上一个普通 UA(例如
curl/8.9.1)就通了——有些网关会对默认的Python-urllib/3.x做拦截。
调用顺序很朴素:先 initialize 拿能力,再 tools/list 看参数契约,最后 tools/call。别凭直觉写参数名,先 list 一遍,字段名、长度限制、必填项都在 schema 里。
二、交付要走契约
平台有一个「取交付规则」的工具,返回目标客户、频道、体积上限、入口文件名、允许的格式。正确顺序是:
- 先取规则,核对客户/频道是不是自己要投的那个;对不上就停,不要猜。
- 单文件 HTML 且体积在上限内,走 inline 提交;含 CSS/JS/图片/字体等资源,打 ZIP(根目录必须是
index.html),然后走「创建交付 → 按返回的上传契约本地上传真实文件 → 完成交付」三步。 - 只有最终状态是
published才算送达,uploaded只是暂存到对象存储。
三、幂等:external_id 是命根子
定时任务最怕重复投递。做法是每一轮生成一个唯一的 external_id,连同原始文件的 SHA-256 和字节数一起落盘:
{
"external_id": "daily-report-2026-11-11-001",
"sha256": "...",
"bytes": 5990,
"status": "published"
}
重试时沿用原来的 external_id 和原来的文件,不重新打包、不重新生成(时间戳一变内容就变了)。平台对同一个 external_id 返回已有 report_id 而不是新建记录,这正是我们想要的语义。网络超时也别急着重提,先查一次状态:很可能已经成功,只是响应没回来。
四、凭证只放本机
Token 属于「只写一次、永不外传」的东西:存在客户端私有配置文件里,报告里、日志里、代码仓库里都不能出现。我的报告 HTML 是纯前端产物,本来就不需要调后端接口,所以凭证泄露面为零。
五、报告本身要自包含
交付平台的限制里有几条很关键:不使用远程 JS/CDN/API、不执行服务端代码、不把二进制塞进模型上下文做 Base64。所以报告最好是一份彻底自包含的 HTML:样式内联、图表用 SVG 或纯 CSS 画、交互用几十行原生 JS。这样在任何环境打开都不会白屏,也不会因为外部资源失效变成一堆方块。
小结
整条链路其实就四句话:先核对规则,再按契约提交,用 external_id 保证幂等,用 published 判断成败。把它挂到定时调度后面,你就有了一个不吵你、但每天准时把结果送到手机上的小助手。
- 点赞
- 收藏
- 关注作者
评论(0)