Kaze Feed
Provides RSS/Atom feed subscription management, incremental polling, cached queries, and per-session consumption state, allowing agents to track feeds and retrieve new entries from RSS/Atom sources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kaze Feed subscribe to https://example.com/feed.xml and fetch the latest entries"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kaze Feed
独立的 RSS/Atom MCP 服务,供 Kaze 从私有 GitHub 仓库安装。维护订阅、增量采集、缓存查询和按会话区分的消费状态;筛选、通知和用户兴趣管理由 Kaze 负责。
需要 Python 3.12+。MCP 服务运行于独立虚拟环境,数据库保存到 Kaze 工作区的 mcp-data/kaze-feed,更新代码不会覆盖数据库。
让 Kaze 安装
在 Kaze 对话中发送下面这段请求:
从 https://github.com/jackeyfaker77/kaze-feed 安装 Feed MCP。
确认当前 Kaze 的实际工作区路径,将仓库克隆到工作区下的 mcp/kaze-feed。
用 Python 3.12+ 运行 scripts/prepare.py --workspace 实际工作区路径。
将脚本输出的 JSON 原样传给 mcp_add,server 名称使用 feed。
再用 mcp_list 和 mcp_feed__feed_status 验证连接,告诉我结果。
已有同名 MCP 或不同的 feed-manage skill 时保留现有配置并说明冲突。
安装后保持订阅列表为空,等待我提供 RSS/Atom 地址。私有仓库需要本机已经登录且有仓库访问权的 GitHub 账号。安装脚本准备自己的 .venv、安装服务,并添加工作区 feed-manage skill。注册由 Kaze 的 mcp_add 完成;脚本不会编辑 mcp_servers.json、修改 HEARTBEAT.md 或开启推送。
Windows 手动准备
先进入 Kaze 的实际工作区。开发版通常是项目的 workspace,安装版通常是用户目录下的 .hasaki/workspace;以 Kaze 自己报告的路径为准。
git clone https://github.com/jackeyfaker77/kaze-feed.git mcp/kaze-feed
python mcp/kaze-feed/scripts/prepare.py --workspace .将输出的 JSON 交给 Kaze 调用 mcp_add。路径会转换为绝对路径,输出类似:
{
"name": "feed",
"command": [
"E:/your-workspace/mcp/kaze-feed/.venv/Scripts/python.exe",
"E:/your-workspace/mcp/kaze-feed/run_mcp.py"
],
"env": {
"KAZE_FEED_DATA_DIR": "E:/your-workspace/mcp-data/kaze-feed"
}
}重复准备保留数据。已有不同的工作区 skill 时停止覆盖;用 --skip-skill 保留它。开发验收可用 --skip-install 跳过已经完成的依赖安装。
Related MCP server: feed-reader-mcp
工具
注册名为 feed 时,工具前缀为 mcp_feed__。
工具 | 用途 |
feed_manage | list、subscribe、unsubscribe、pause、resume;删除用精确名称或 source_id |
poll_feeds | 采集到期来源;每次最多四个;返回失败原因与 remaining |
feed_query | latest、search、summary、sources、catalog;仅读缓存 |
get_proactive_events | 查询某个 consumer 最近 36 小时内未消费的候选 |
acknowledge_events | 记录消费状态;可指定有效期;按 consumer 隔离 |
feed_status | 查看缓存条数、最近采集时间和来源错误 |
mcp_feed__feed_manage(action="subscribe", name="示例", url="https://example.com/feed.xml")
mcp_feed__poll_feeds()
mcp_feed__feed_query(action="latest", limit=10)返回 remaining>0 时可继续调用 poll_feeds。普通查询不会联网,刷新时显式采集。RSSHub 等生成的有效 RSS 地址可直接订阅;本服务不会将 Twitter/X 用户名转换成未经验证的第三方地址。
消费状态与主动推送
get_proactive_events 的读取不改变状态。consumer 使用目标会话的 session_key,例如 desktop:xxx,避免一个会话的 ACK 屏蔽其他会话。
poll_feeds
→ get_proactive_events(consumer=目标会话)
→ Kaze 筛选与生成通知
→ Kaze 实际发送并取得回执
→ acknowledge_events(reason="delivered", delivery_ref=真实回执)reason 支持 processed、read、discarded、delivered。默认 ACK 永久有效;正数 ttl_hours 使候选在到期后可能重新出现。delivered 要求 delivery_ref,但引用由宿主提供,Feed 服务不会独立验证送达。不可用“已生成回复”或“准备发送”代替回执。
当前 Kaze 的简化 heartbeat 没有稳定的送达回执和“送达后 ACK”协调层。因此安装后可使用订阅和查询,可靠的自动推送需要 Kaze 宿主另行接入。仅在 prompt 写“推送之后 ACK”,无法覆盖发送失败、进程中断和重复执行。
被丢弃的条目可使用 discarded 消费;发送失败保持未消费,留待宿主重试。Feed 不直接访问 Telegram、QQ 或桌面通知。
数据与更新
RSS GUID / Atom ID 优先作为条目身份,缺失时用规范化原文 URL。
标题或发布时间更新保留 event_id;发布时间统一为 UTC。
ETag / Last-Modified 减少重复下载;304 保留正文和消费状态。
单源失败保留旧缓存并返回结构化错误;一次请求整体最多 8 秒,瞬时失败重试一次。
30 天未再观察到的条目会被清理,消费记录随条目删除。仍在当前 feed 的身份继续保留。
KAZE_FEED_DATA_DIR 指定数据目录;直接运行默认使用用户目录下的 .kaze-feed。
升级时在插件目录 git pull,再运行准备脚本。Kaze 当前 mcp_add 不支持原地替换已有连接;更新运行中的服务需先 mcp_remove(name="feed"),再 mcp_add。移除连接不会删除数据。
开发与验证
python -m venv .venv
.venv/Scripts/python.exe -m pip install -e ".[test]"
.venv/Scripts/python.exe -m pytest -q
.venv/Scripts/python.exe scripts/check_kaze.py --backend E:/CODE/hasaki-agent/apps/backend最后一项使用 Kaze 真实的 stdio MCP 客户端及临时本地 HTTP feed,检查握手、六个工具、中文、采集、缓存、会话消费隔离、标题更新和重启恢复;不会连接真实信息源或修改 Kaze 的运行工作区。
源码审查见 参考实现审查。工具职责参考 kachofugetsu09/feed-mcp;核心实现独立编写,使用 MIT License。
Available Tools
6 toolsacknowledge_eventsA
记录条目已处理、已读、已丢弃或已送达:processed、read、discarded、delivered。
默认永久消费,ttl_hours 为正数时可在到期后重新出现。 delivered 必须提供宿主真实送达回执 delivery_ref;本服务不验证回执真实性。 准备推送或发送失败都不能标记为已送达。未知 ID 单独返回 missing。
Inputs: event_ids (required), reason, consumer, ttl_hours, +1 more.
feed_manageB
管理 RSS/Atom 订阅:list、subscribe、unsubscribe、pause、resume。
URL 必须是 HTTP/HTTPS RSS 或 Atom 地址。删除和暂停使用精确名称或 source_id。 订阅后用 poll_feeds 采集,不会自动推送消息。
Inputs: action (required), url, name, note, +2 more.
feed_queryA
查询已缓存的订阅内容:latest、search、summary、sources、catalog。
查询不触发网络采集。需要刷新时先调用 poll_feeds,并检查失败来源。 返回标题、摘要、原文、发布时间及稳定 event_id。
Inputs: page, limit, action, source, +2 more.
feed_statusC
查看来源的最近采集时间、成功时间、失败原因和缓存条数。
Inputs: source.
get_proactive_eventsA
读取最近 36 小时内尚未被此 consumer 消费的候选内容。
不采集、不发送消息、不自动 ACK。consumer 应使用目标会话的 session_key。
Inputs: limit, consumer.
poll_feedsA
采集到期 RSS/Atom 来源,每次最多四个,按上次采集时间轮换。
force=true 忽略采集间隔。返回 ok、failed、remaining 和每个来源的结果。 remaining>0 时可继续调用;失败时保留旧缓存并记录原因。
Inputs: force, source.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct phase of the feed lifecycle: manage subscriptions, query cache, poll sources, read proactive events, acknowledge events, and check status. Slight overlap exists between feed_query (latest) and get_proactive_events for reading content, but the consumer/session_key workflow and explicit no-collect/no-send semantics differentiate them.
All names use snake_case, but the prefix/style is mixed: feed_manage, feed_query, and feed_status use a noun-first pattern, while poll_feeds, get_proactive_events, and acknowledge_events are verb-first. The set is readable but lacks a single predictable convention.
Six tools is well-scoped for an RSS/Atom feed and event-consumption server. Each tool has a clear, non-redundant purpose, and no tool feels trivial or out of place.
The surface covers subscription CRUD (subscribe, list, unsubscribe, pause, resume), polling, querying cached content, proactive event retrieval, acknowledgement, and status. Minor gaps exist, such as fetching a single event by ID or bulk acknowledgement, but core workflows are complete.
Maintenance
Related MCP Connectors
RSS & Atom feed manager with full-text search, AI curation, and remote MCP endpoint.
RSS, Atom and JSON feeds for agents: find a site's feed, read items as JSON, keyless news search.
Managed cloud RSS and Atom feed reader with a remote Model Context Protocol (MCP) endpoint. Zero server setup required — enables AI agents like Claude to instantly subscribe to feeds, search full-text articles, extract readable content, and access curated AI editions ("Your Newspaper") over secure streamable HTTP.
Track and browse RSS feeds with ease. Fetch the latest entries from any feed URL and extract full…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides tools to list, read, and fetch RSS/Atom feeds, with curated categories and robust fetching capabilities.13 npmMIT
- AlicenseAqualityDmaintenanceFetches and reads RSS/Atom feeds, enabling MCP clients to pull latest items from blogs, news sites, and release feeds and build digests.237 npmMIT
- AlicenseAqualityBmaintenanceEnables MCP clients like Claude to subscribe to RSS/Atom feeds, list feeds with unread counts, fetch and search new items, and mark items as read, all scoped to the authenticated user's account.8341MIT
- AlicenseNot gradedqualityDmaintenanceEnables users to search a curated RSS/Atom catalog, subscribe to and collect feeds, and query collected articles through natural-language tools.2MIT