用 MCP + 本机 HTTP 搭一条无人值守的数据简报交付链路

举报
yd_277423341 发表于 2026/11/11 09:28:56 2026/11/11
【摘要】 背景很多人的定时任务是这样的:每天早上六点,脚本在服务器上跑完,输出一份统计结果,然后……就没有然后了。结果只停在日志里或者对话框里,要人主动去看。真正想要的是:跑完自己生成一份好看的日报,直接推到你手机上。这两天我把自己的一个每日任务接上了 MCP 交付平台,走通了「定时任务 → 生成自包含 H5 → 远程 MCP 交付 → 消息通知」这条链路。下面记录几个关键点,都是实打实踩出来的。 ...

背景

很多人的定时任务是这样的:每天早上六点,脚本在服务器上跑完,输出一份统计结果,然后……就没有然后了。结果只停在日志里或者对话框里,要人主动去看。真正想要的是:跑完自己生成一份好看的日报,直接推到你手机上。

这两天我把自己的一个每日任务接上了 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

两个容易挂的地方:

  1. 协议版本头。握手时服务端会协商出 protocolVersion,之后的 tools/call 必须带上 MCP-Protocol-Version,否则直接报 unsupported_protocol。用官方 SDK 会自动带,手写请求很容易忘。
  2. User-Agent。用 Python urllib 直连时被 403 挡了一次,加上一个普通 UA(例如 curl/8.9.1)就通了——有些网关会对默认的 Python-urllib/3.x 做拦截。

调用顺序很朴素:先 initialize 拿能力,再 tools/list 看参数契约,最后 tools/call。别凭直觉写参数名,先 list 一遍,字段名、长度限制、必填项都在 schema 里。

二、交付要走契约

平台有一个「取交付规则」的工具,返回目标客户、频道、体积上限、入口文件名、允许的格式。正确顺序是:

  1. 先取规则,核对客户/频道是不是自己要投的那个;对不上就停,不要猜。
  2. 单文件 HTML 且体积在上限内,走 inline 提交;含 CSS/JS/图片/字体等资源,打 ZIP(根目录必须是 index.html),然后走「创建交付 → 按返回的上传契约本地上传真实文件 → 完成交付」三步。
  3. 只有最终状态是 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 判断成败。把它挂到定时调度后面,你就有了一个不吵你、但每天准时把结果送到手机上的小助手。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。