Skip to main content
Glama
Cloud MCP Guanlan

Cloud MCP Guanlan

by uichat-mira

Cloud MCP Guanlan · 云端观澜

Mira Cloud 的基础新闻采集与聚合服务。

观澜接受用户配置的公共/私人新闻源与关注点,按小时级配置持续采集标题、摘要、原文链接及必要元数据,向授权的外部 Agent 提供统一、可追溯、可增量消费的新闻候选,并维护每个消费者独立且持久的处理状态。

观澜负责“采集和记账”,不负责“理解与决策”。外部 Agent 自行选择是否 Web Fetch 原文、是否采用新闻,并明确回写处理结果。

当前能力: 已有公共 Feed 采集与 D1 租约/去重 POC、受保护的只读 MCP 服务端,以及 GLN-005 的多用户数据模型。GLN-003 的隔离 Cloudflare 实测已完成研究验收,但 Workers Free 持续 Cron CPU 裕量仍未获放行;真实 Cloud Auth 账号联调、私有订阅查询/消费账本、Desktop/Mobile 接入和生产上线尚未完成。 请勿将本 README 中的目标能力理解为已经上线的 API 或 Cloudflare 服务。

设计入口

产品与服务设计 v0 是本仓库产品决策、非目标、消费状态、授权边界及待决问题的单一真相源。README 只做概览,不重复维护完整契约。

远程 MCP 是外部 Agent 的 canonical 集成入口;当前协议、Cloud Auth 边界、工具与未交付依赖见 GLN-004 工程边界。REST 不作为平行的 Agent API。

Related MCP server: NewsAgent Data MCP server

已确定的核心原则

  • 独立云服务,多用户使用。 身份统一由 Mira Cloud Account / Cloud Auth 提供,不再自建账号体系。

  • 公共源 + 个人订阅。 私人订阅和关注点不公开;同 URL 可以在后台复用采集,不泄漏订阅关系。

  • 轻量新闻索引。 仅标题、摘要、原文链接及必要元数据;不抓全文、不生成 AI 摘要、不做事件级聚类。

  • 关键词筛选而非语义智能。 默认按关注点读取;Agent 可以主动扩大到有权限的新闻范围。

  • 明确消费状态。 未读、已读待决、已采用、已忽略;读取无副作用,显式回写,换会话后不丢处理记忆。

  • 每个消费者独立。 不同 Agent 对同一条新闻可以做不同决定,状态可附可选理由和成果链接。

  • 面向 Agent 的统一视图。 Markdown 优先、JSON 辅助;每个 Agent 可以获得专属、可撤销的私人只读链接,写入仍需单独授权。

  • 建议不等于修改。 Agent 可以提出订阅配置建议,只有用户确认后才能生效。

  • 新闻索引保留 90 天。 精简去重指纹和处理记忆长期保留,仍支持授权撤销及必要的数据删除。

  • 小时级采集间隔配置。 不要求实时推送。

首选部署方向(待技术验证)

以 Cloudflare Workers Free + Cron Triggers + D1 为第一候选,力求零额外费用、有限资源下的可靠服务;这不排除未来上阿里云,但大陆用户入口及新闻源出口可达性都必须真实验证,多 Worker/双部署暂不建设。已验证隔离 Canary 的真实运行,但 10ms Free 单次 CPU 仍缺乏可靠余量;免费额度耗尽时的降级优先级仍由维护者决定。

不为首版默认引入 LLM、向量检索、浏览器抓取、内置 Agent 或额外付费基础设施。

与已有 Mira Desktop 的关系

Desktop 的本地 NewsHub 已有采集、订阅、SQLite 缓存和检索实现。这里是新的云服务边界,不是将整个桌面后端原样搬进 Worker;本仓库不自动授权改变或移除现有桌面能力。

参考:

项目状态与工程协作

GLN-003 是已完成的隔离运行研究,结论仍是不批准依赖 Free 10ms CPU 的长期 Cron;相关 Canary 保留且调度关闭。GLN-004 的远程 MCP 协议代码已并入 dev,但不代表真实 Cloud Auth 令牌或客户端已经接通。GLN-005 的多用户持久化模型也已进入 dev。

  • 仓库工程约束

  • Issue 任务卡与付费 OpenCode Worker 使用说明

  • bash scripts/check.sh:有运行时代码后执行完整 npm run check(类型、解析、真实 workerd/D1 集成、Wrangler dry-run、同环境基准)。

  • GLN-001 技术证据:运行结果、选型结论和剩余限制。

  • .github/workflows/mira-external-worker.yml:可信 Issue 评论触发付费 OpenCode Worker,交付 Draft PR 到 dev,不自动合并。

  • .github/workflows/ci.yml:Mira Gate 与分支流程检查,执行结果以真实 Actions 为准。

后续按 Mira Organization AGENTS 小步实现、用运行证据验收。仓库当前默认分支为 dev;尚未创建 test 或 prod 环境分支。

License

MIT

Cloudflare 隔离验收(GLN-003)

GLN-003 工程手册与证据状态 记录专属 Workers/D1 Canary 的真实执行、CPU/行用量与安全收尾;九次 CPU 三段剖析报告 记录解析与 D1 成本。当前 Canary 保留但 Cron 关闭,不是产品上线。 npm run test:canary / npm run dry-run:canary 仅验证隔离配置和真实应用打包,不产生云端副作用。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Enables querying scored and classified Russian and English news via MCP clients, offering filtered feeds, keyword search, breaking news, and coverage stats.
    5
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables agents to query news and research metadata through MCP tools, either by wrapping a compatible news platform or enabling public provider adapters, while preserving attribution and publisher credit.
    34 npm
    1
    MIT