MCP RSS 聚合器

功能

• 直接在 Claude 桌面版中阅读您喜爱的 RSS 源的文章
• 支持 OPML 文件以导入现有的订阅源
• 按类别组织订阅源
• 获取所有订阅源中的最新文章
• 按订阅源或类别筛选文章
• 文章格式良好，包含标题、摘要和链接

演示

点击任意时间戳跳转到视频相应部分

00:00 - 示例 RSS 源演示:
使用存储库中包含的默认 sample-feeds.opml 文件。此部分展示了 Claude 如何通过 MCP（模型上下文协议）处理并呈现来自 TechCrunch、The Verge 等技术出版物的新闻内容。

01:05 - 配置文件编辑过程:
逐步介绍如何访问和修改 claude_desktop_config.json 文件，将 OPML 文件路径引用从默认示例更改为自定义的 my-feeds.opml 文件。

01:15 - 应用程序重启过程:
说明了关闭并重新打开 Claude 桌面应用程序以正确加载和应用修改后的 OPML 文件配置更改的必要步骤。

01:25 - 自定义 RSS 源结果:
展示实施自定义 OPML 文件后的结果。此部分突出了现在通过 Claude 桌面版可获得的更多样化的新闻来源，包括西班牙语内容。

要求

• Node.js 16 或更高版本
• Claude 桌面版
• 互联网连接以访问 RSS 源

安装

手动安装

1. 克隆或下载此仓库：
   bash
   git clone https://github.com/imprvhub/mcp-rss-aggregator
   cd mcp-rss-aggregator

2. 安装依赖项：
   bash
   npm install

3. 构建项目：
   bash
   npm run build

订阅源配置

RSS 聚合器支持 OPML 和 JSON 格式的订阅源配置。

使用 OPML（推荐）

OPML（大纲处理器标记语言）是大多数 RSS 阅读器用于导出和导入订阅源的标准格式。

一个包含热门订阅源的示例 OPML 文件位于 public/sample-feeds.opml 文件中。您可以：

1. 直接使用此文件
2. 编辑它以添加您自己的订阅源
3. 将其替换为您现有 RSS 阅读器的导出文件

大多数 RSS 阅读器允许您将订阅导出为 OPML 文件。

使用 JSON

或者，您可以在 JSON 文件中定义您的订阅源，格式如下：

json
[
{
"title": "Hacker News",
"url": "https://news.ycombinator.com/rss",
"htmlUrl": "https://news.ycombinator.com/",
"category": "科技新闻"
},
{
"title": "TechCrunch",
"url": "https://techcrunch.com/feed/",
"htmlUrl": "https://techcrunch.com/",
"category": "科技新闻"
}
]

运行 MCP 服务器运行MCP服务器有两种方法：

选项1：手动运行

1. 打开终端或命令提示符
2. 导航到项目目录
3. 直接运行服务器：

bash
node build/index.js

在使用Claude Desktop时，请保持此终端窗口打开。服务器将一直运行，直到您关闭终端。

选项2：通过Claude Desktop自动启动（推荐用于常规使用）

Claude Desktop可以在需要时自动启动MCP服务器。要设置这一点：

配置

Claude Desktop的配置文件位于：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%Claudeclaude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

编辑此文件以添加RSS聚合器MCP配置。如果文件不存在，请创建它：

json
{
"mcpServers": {
"rssAggregator": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"],
"feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
}
}
}

重要说明：

• 将ABSOLUTE_PATH_TO_DIRECTORY替换为您安装MCP的完整绝对路径
  • macOS/Linux示例: /Users/username/mcp-rss-aggregator
  • Windows示例: C:\Users\username\mcp-rss-aggregator
• 将ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml替换为您的OPML或JSON文件的路径
  • 如果省略，则将使用示例订阅源文件

如果您已经配置了其他MCP，只需在mcpServers对象内添加"rssAggregator"部分即可：

json
{
"mcpServers": {
"otherMcp1": {
"command": "...",
"args": ["..."]
},
"rssAggregator": {
"command": "node",
"args": [
"ABSOLUTE_PATH_TO_DIRECTORY/mcp-rss-aggregator/build/index.js"
],
"feedsPath": "ABSOLUTE_PATH_TO_YOUR_FEEDS_FILE.opml"
}
}
}

根据claude_desktop_config.json文件中的配置，当Claude Desktop需要时，MCP服务器将自动启动。

使用方法

1. 修改配置后重启Claude Desktop
2. 在Claude中使用rss命令与RSS聚合器MCP服务器交互
3. MCP服务器作为由Claude Desktop管理的子进程运行

可用命令

RSS聚合器MCP提供了一个名为rss的工具，包含以下命令：

示例用法

以下是使用Claude进行RSS聚合的一些示例：

直接命令：

rss latest
rss top --20
rss list
rss "Tech News"
rss --hackernews
rss --techcrunch --15

自然语言查询：

您还可以使用自然语言与MCP交互。Claude会解释这些请求并使用适当的命令：

• "Hacker News上最新的新闻是什么？"
• "显示今天的顶级科技文章"
• "从我的编程订阅源获取最新文章"
• "列出我所有的RSS订阅源"

扩展使用示例

每日新闻简报

从所有来源获取新闻简报：

rss latest --25

这将从所有订阅源中获取最近的25篇文章，为您提供最新新闻的快速概览。

探索顶级内容

查找最重要的或最受欢迎的文章：

rss top --20

基于类别的阅读

专注于特定的内容类别：

rss "Tech News" --30
rss "Politics" --15
rss "Science" --10### 针对特定来源的更新

从你关注的特定来源读取更新：

rss --hackernews --20
rss --nytimes
rss --techcrunch --15

发现可用的订阅源

查看你已配置的订阅源：

rss list

组合多个请求

你可以进行多个顺序请求以构建全面视图：

rss "Tech News" --10
rss "Finance" --10
rss top --5

实用工作流程

1. 晨间例行程序：

   rss top --10
   rss "News" --5

2. 行业研究：

   rss "Industry News" --15
   rss --bloomberg --5

3. 技术更新：

   rss --hackernews --10
   rss --techcrunch --5

与Claude协作

你可以让Claude分析或总结文章：

1. 在运行 rss latest --10 后：
   询问： "Can you summarize these articles?"

2. 在运行 rss "Tech News" --15 后：
   询问： "What are the key trends in these tech articles?"

3. 在运行 rss --nytimes --washingtonpost --10 后：
   询问： "Compare how these sources cover current events"

故障排除

"Server disconnected" 错误

如果你在Claude Desktop中看到错误 "MCP RSS Aggregator: Server disconnected"：

1. 验证服务器是否正在运行：

   • 打开终端并从项目目录手动运行 node build/index.js
   • 如果服务器成功启动，请保持此终端打开并使用Claude

2. 检查你的配置：

   • 确保 claude_desktop_config.json 中的绝对路径对你系统是正确的
   • 检查Windows路径是否使用了双反斜杠 (\)
   • 确认你使用的路径是从文件系统的根开始的完整路径

工具未出现在Claude中

如果RSS聚合工具未出现在Claude中：

• 确保你在配置后重启了Claude Desktop
• 检查Claude Desktop日志中的任何MCP通信错误
• 确保MCP服务器进程正在运行（手动运行以确认）

订阅源无法加载

如果你的订阅源无法正常加载：

• 确保你的OPML/JSON文件格式正确
• 检查配置中的 feedsPath 是否正确
• 尝试使用一个已知良好的订阅源文件手动运行服务器

贡献

欢迎为RSS聚合器做出贡献！以下是一些你可以贡献的方式：

1. 增加对更多订阅源格式的支持
2. 改进订阅源解析和错误处理
3. 为文章增加更多的可视化选项
4. 改进分类和过滤功能

许可证

本项目根据Mozilla Public License 2.0许可发布 - 详情请参见 LICENSE 文件。

相关链接

• Model Context Protocol
• Claude Desktop