DATAHUB BRIEF MCP

让每次任务的结果,
自动成为一份简报。

监控和分析留在你的机器上。连接 MCP,把生成的报告交给数据简报平台,客户就能在 App 或网页中阅读。

远程服务地址https://dhb.365724.top/mcp
  1. 01 本机生成报告
  2. 02 MCP 交付
  3. 03 平台归档阅读

支持小型 HTML 和包含 CSS、JS、JSON、图片的静态报告包。平台提供统一交付规则,不需要为每种监控业务单独设计上传接口。定时调度、数据采集和内容生成仍由你的本机程序负责。

01 / QUICK START

从一个频道开始接入

  1. 准备客户和频道

    在后台进入对应客户,新建或选择频道,例如“B 站监控日报”,取得该频道的有效接入凭证。

  2. 添加项目 MCP 连接

    在“接入凭证”中点击“复制 MCP 配置”,放进当前项目的私有设置。也可以使用下方模板填写自己的 Token。

  3. 核对目标,交付一次

    调用 datahub_get_delivery_rules 核对客户和频道,再发送一份“接入测试”报告。收到 published 后,到 App 或网页检查实际内容。

  4. 接入原有定时任务

    测试通过后,将交付步骤接到程序末尾。确认定时运行时,也能读取相同的项目配置、凭证和文件。

02 / CONNECTION

一个地址,一枚频道 Token

使用远程 Streamable HTTP 连接。认证信息放在请求头,不需要提供 App 密码或额外指定客户、频道;服务端通过 Token 确定接收目标。

WorkBuddy · 项目配置
{
  "mcpServers": {
    "datahub-current-project": {
      "type": "streamableHttp",
      "url": "https://dhb.365724.top/mcp",
      "headers": {
        "Authorization": "Bearer <当前项目的频道Token>"
      },
      "timeout": 30000
    }
  }
}

本平台提供的默认模板位置为 .workbuddy/mcp.json。实际配置入口和字段支持以当前 WorkBuddy 版本为准;无法自动写入时,在客户端 MCP 管理界面手动配置并启用。

只在本机填写真实 Token

本页不会把你填写的 Token 上传服务器或持久保存。配置模板中的占位符在本机替换,也可以在下方输入 Token,自动填入 WorkBuddy 接入指令。

03 / WORKBUDDY

把这段话发给 WorkBuddy

适合已经有监控程序、希望接入自动交付的项目。填写当前项目的 Token,下方指令会自动更新,直接复制给 WorkBuddy 即可。

仅在当前页面内填充,不发送到服务器,不持久保存;复制的指令会包含你的 Token。

未填写时,复制的指令保留 Token 占位符。

首次接入 · 含真实测试交付
请将当前项目正在定时执行的程序,接入我的 DataHub Brief 数据简报平台,并实际完成一次测试交付。

MCP 地址:https://dhb.365724.top/mcp
认证方式:Authorization: Bearer <在本机填写当前项目的频道Token>

请直接完成配置和程序调整:
1. 在当前项目配置远程 MCP,Token 只保存在本机私有配置,不放进报告、日志或代码仓库。
2. 调用 datahub_get_delivery_rules,核对返回的客户、频道和交付规则。目标不符时停止交付并告诉我。
3. 保留现有监控逻辑和执行时间,每次生成报告后自动上传。确保定时进程也加载当前项目的 MCP、Token 和工作目录。
4. 小型完整 HTML 使用 datahub_submit_html;包含 CSS、JS、JSON、图片等资源时,生成自包含 ZIP,根目录 index.html。调用 datahub_create_delivery,再使用本机 HTTP/文件能力按返回的 upload 契约上传真实文件,最后调用 datahub_complete_delivery。
5. 每轮报告生成唯一 external_id 并持久保存。重试保留原编号、元信息和内容;冻结原ZIP并记录字节数、SHA-256,不在重试时重新打包。断网或超时先查询状态。
6. 只有 published 才标记送达,uploaded 仅代表暂存。返回已有 report_id 时保存原结果,不重复新建;deleted/gone 不自动恢复。
7. 现在先提交一份标题含“接入测试”的报告,返回实际客户、频道、external_id、report_id 和最终状态。测试成功后,把同一交付流程接到定时任务末尾。

该 Token 仅用于当前项目,其他项目使用自己的 Token。如果客户端无法自动添加 MCP,请明确告诉我需要手动填写的配置,完成后继续真实测试,不要只生成接入方案。
已经配置好?展开日常定时任务指令
日常交付 · 不重复填写 Token
本项目每次生成报告后,通过当前项目已配置的 DataHub Brief MCP 自动交付。
先读取交付规则并核对客户和频道。小型完整HTML直接提交;多资源报告使用自包含ZIP,资源使用相对路径。
持久保存本轮external_id、元信息和冻结文件;ZIP同时保存真实字节数和SHA-256。按工具返回的契约创建任务、上传并确认发布。
超时先查询:published保存原report_id;uploaded继续complete;awaiting_upload按原参数获取新票据;publishing按next_action等待或继续。失败或过期按提示处理,不换编号盲目重发,deleted/gone不自动重发。
保留现有定时安排,确保运行时加载正确项目配置。只有published才标记送达,记录编号及结果,不记录Token和临时票据。

指令需要客户端具备 MCP、文件和本机执行权限。复制指令或保存配置本身不代表交付完成,最终以工具返回的实际发布结果为准。

04 / DELIVERY

选择适合报告的交付方式

内容交付方式默认限制
小型完整 HTML调用 datahub_submit_html1 MiB
HTML + 图片、图表、脚本等ZIP:创建任务 → 上传 → 确认发布50 MiB;解压 200 MiB / 2000 文件
单个受支持的静态文件创建任务 → 上传 → 确认发布50 MiB

多资源报告,推荐 ZIP

report.zip
├── index.html
├── data.json
└── assets/
    ├── style.css
    ├── app.js
    └── chart.png

默认首页为根目录 index.html,资源使用相对路径并随包上传,不依赖本机路径、外网 CDN 或额外登录的 API。特殊入口使用 entry_path 明确指定。

创建文件任务时填写原文件的真实字节数和 SHA-256。MCP 返回临时上传契约后,用本机 HTTP 能力上传真实文件;云端不能读取你的本机路径,也不接收用 Base64 代替 ZIP 的工具参数。

上传完成 ≠ 报告发布

uploaded 只表示已暂存和校验,继续调用 datahub_complete_delivery,得到 published 才算交付完成。

静态包仍受文件白名单和阅读环境安全策略限制,不运行 PHP、Python 或 Node 服务端程序。复杂 JS 交互应在实际 App 中验证。

05 / TOOLS

五个工具,完成交付闭环

工具用途与核心参数
datahub_get_delivery_rules获取客户、频道及当前规则,无需参数。
datahub_submit_html发布 HTML:external_id、title、html。
datahub_create_delivery创建文件任务:external_id、title、filename、file_size、sha256。
datahub_complete_delivery确认发布:delivery_id。
datahub_get_delivery_status查询本凭证的任务:delivery_id 或 external_id,二选一。

HTML 与文件任务支持可选摘要和报告日期。具体参数以客户端发现的工具定义和服务器返回规则为准,Token 不是工具参数。

超时先查询,重试不换编号

external_id 标识一轮交付。同一频道中保持唯一,每次新报告使用新编号;重试保持原编号、元信息和内容,冻结的 ZIP 不要重新打包。服务器返回的 delivery_id 是任务编号,report_id 是正式报告编号。

状态下一步
awaiting_upload按原创建参数取得有效票据后上传。
uploaded调用 complete 确认发布。
publishing按 next_action 等待查询或继续发布。
published保存 report_id,结束本轮;重复返回原结果也算已交付。
failed / expired根据错误与可重试提示处理;过期尝试按原内容和编号重建。
deleted / gone报告已删除,不通过自动重试恢复。

当前 MCP 不提供以相同编号覆盖已发布内容的更新工具。确实需要发布修正版时使用新的业务编号,例如 bilibili-a-20261102-rev2。

06 / AUTOMATION

多台机器,多个项目,都能接入

所有项目使用同一个 MCP 服务地址,每个项目保存自己的频道 Token。不要让不同项目共用一个不断被覆盖的全局凭证。若客户端仅支持全局配置,可建立不同名称的连接,并让任务选用各自连接。

  • 定时进程绑定正确的项目目录、用户、MCP 配置和文件路径。
  • 持久保存待发送记录和冻结文件,机器重启后继续处理未完成交付。
  • 同一频道的不同机器协调生产任务与编号,避免互相重复提交。
  • 任务绑定创建它的具体 Token;切换凭证前先处理好在途任务,停用凭证会阻断后续上传和发布。

当前默认每 Token 最多两个未完成任务,上传票据有效 15 分钟、一次尝试有效 24 小时;暂存空间、正式客户配额及请求频率还受服务器配置限制。

07 / FAQ

接入时的常见问题

浏览器打开 /mcp 返回405,是服务坏了吗?

不是。它是 MCP 协议地址,不是介绍网页。请用客户端连接;健康地址是 https://dhb.365724.top/mcp/health。健康200也不代表当前 Token 已通过认证。

返回401,应该检查什么?

检查认证头、频道 Token 是否有效、过期或撤销,以及客户和频道是否停用。上传请求使用短期票据,过期后先查任务,再按原参数获取新票据。

工具能调用,为什么无法上传本机文件?

云端不能直接读取 Mac 的文件路径。需要客户端使用本机文件和 HTTP 能力,按 create 返回的 upload 契约上传真实文件,然后调用 complete。

手动运行成功,定时运行失败怎么办?

核对定时进程的用户、工作目录、私有凭据、MCP 加载方式、网络和执行权限。实际触发一次定时任务验证,不只在交互会话中测试。

出现429、413或507怎么办?

429按重试提示等待或先完成已有任务;413检查文件大小、解压量、暂存预留和客户配额;507检查服务器剩余空间。不要通过不断更换编号重发来绕过错误。

报告会自动公开吗?可以通过 MCP 分享或删除吗?

上传报告按原平台权限提供阅读,不默认公开。导出、分享、取消分享和删除使用平台原有客户功能,当前五个 MCP 工具不提供这些管理操作。已发布也不保证手机推送已经送达。