briefings

briefing-mcp

Briefing Service 的 MCP 服务：每小时由一位大模型编辑从每个主题约 100 个信息源中进行排名（AI 新闻、AI 研究、前沿实验室、市场、美国体育、欧洲足球、美国新闻、世界、加密货币和链上动态），并发布两个每日版本（Grants & Funding：新发布的联邦资助通知，每条均附截止日期／金额／符合条件对象；Noticias Lentas：以 CEFR B1 难度的简单西班牙语呈现当日新闻，并附词汇表）。结果以结构化 JSON、渲染后的 480x800 电子墨水页面、多页 Morning Paper PDF，以及免费提供的全部候选项来源记录的形式发布。

此软件包通过 stdio 在本地运行，并调用公共 REST API。相同的工具也通过远程方式提供（可流式传输的 HTTP，无需安装）：https://briefing-service.wholemind.workers.dev/mcp。

安装

Claude Desktop / Claude Code / Cursor / 任意 stdio 客户端：

{
  "mcpServers": {
    "briefings": {
      "command": "npx",
      "args": ["-y", "briefing-mcp"],
      "env": { "BRIEFING_KEY": "" }
    }
  }
}

Claude Code 单行命令：

claude mcp add briefings -- npx -y briefing-mcp

Claude Desktop，一键安装：下载 briefing-mcp-0.1.0.mcpb 并打开（MCP bundle；它会提示输入可选的 Reader 密钥）。

工具

工具	返回内容	费用
list_briefings	11 个键（ai、research、labs、finance、sports、soccer、us、world、crypto、grants、slow-es-b1）、名称和价格	免费
get_briefing(key)	头条、排名后的报道、研究、为何重要、要点	每天每个 IP 免费 25 次，之后需使用密钥或 x402
get_summary(key)	标题和简短概述	免费
get_candidates(key)	本小时的所有候选项：规范链接、媒体来源、selected、以及通过 duplicate_of 标记的合并重复项	免费
get_page(key, page, wide)	480x800 1-bit PNG（或 800x480 横向首页）	每天每个 IP 免费 25 次

定价

• 免费：每天每个 IP 可调用 25 次 JSON／页面／工具，另有摘要和候选项端点。
• Reader 密钥：每月 $9，可无限阅读并接收 Morning Paper。将其设为 BRIEFING_KEY。可在 https://briefing-service.wholemind.workers.dev/billing/checkout 购买。
• 按次付费：通过远程端点使用 x402（Base 上的 USDC）。

面向 Agent 的文档：https://briefing-service.wholemind.workers.dev/llms.txt

工作原理

index.js 是完整的服务端：它使用 @modelcontextprotocol/sdk 注册五个工具，并通过 HTTPS 调用公共 Briefing Service REST API（GET /v1/briefings/...）来响应每个请求。它不存储任何内容，不运行 shell 命令，只读取两个环境变量（BRIEFING_KEY、BRIEFING_BASE_URL）。Dockerfile 构建的也是同一服务；docker run -i 通过 stdio 使用 MCP 协议通信。

在本地运行冒烟测试：

npm install
node client-test.mjs   # lists tools and calls list_briefings, get_summary, get_candidates, get_page, get_briefing

关于整个处理流程（收集、实体重叠去重、大模型编辑、1-bit 渲染）以及第一周经验的文章：https://dev.to/jshelley/i-built-an-hourly-newspaper-for-e-ink-and-turned-the-pipeline-into-an-mcp-server-1ebg。每份简报还提供 Atom 源，地址为 /v1/briefings/{key}/feed.xml；Morning Paper PDF 为每篇报道提供大纲、首页快速跳转链接，并在每篇报道的页面上提供可点击的来源 URL。

环境变量

• BRIEFING_KEY：可选的 Reader 密钥（通过 Authorization: Bearer 发送）。
• BRIEFING_BASE_URL：覆盖 API 基础 URL（默认值：公共服务）。

许可证

MIT