mcp-rss-聚合器

MCP RSS 聚合器

集成允许 Claude Desktop 使用模型上下文协议 (MCP) 从您最喜欢的 RSS 提要中获取和读取内容。

特征

直接在 Claude Desktop 中阅读您喜欢的 RSS 源中的文章
支持 OPML 文件导入您现有的订阅源
按类别组织信息流
获取所有动态中的最新文章
按供稿来源或类别过滤文章
格式良好的文章演示，包含标题、摘要和链接

要求

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

安装

手动安装

克隆或下载此存储库：

git clone https://github.com/imprvhub/mcp-rss-aggregator
cd mcp-rss-aggregator

安装依赖项：

npm install

构建项目：

npm run build

供稿配置

RSS 聚合器支持 OPML 和 JSON 格式的 feed 配置。

使用 OPML（推荐）

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

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

按原样使用此文件
编辑它以添加您自己的提要
用现有 RSS 阅读器导出的内容替换它

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

使用 JSON

或者，您也可以使用以下格式在 JSON 文件中定义您的 feed：

[
  {
    "title": "Hacker News",
    "url": "https://news.ycombinator.com/rss",
    "htmlUrl": "https://news.ycombinator.com/",
    "category": "Tech News"
  },
  {
    "title": "TechCrunch",
    "url": "https://techcrunch.com/feed/",
    "htmlUrl": "https://techcrunch.com/",
    "category": "Tech News"
  }
]

运行 MCP 服务器

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

选项 1：手动运行

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

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%\Claude\claude_desktop_config.json
Linux ： ~/.config/Claude/claude_desktop_config.json

编辑此文件以添加 RSS Aggregator MCP 配置。如果该文件不存在，请创建：

{
  "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 文件的路径
- 如果省略，则将使用示例 feed 文件

如果您已经配置了其他 MCP，只需在“mcpServers”对象中添加“rssAggregator”部分：

{
  "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 服务器将自动启动。

用法

修改配置后重启Claude Desktop
在 Claude 中，使用rss命令与 RSS Aggregator MCP Server 进行交互
MCP 服务器作为 Claude Desktop 管理的子进程运行

可用命令

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

命令	描述	参数	例子
`latest`	显示所有源的最新文章	可选限制（--N）	`rss latest --20`
`top`或`best`	显示所有订阅源中的热门文章	可选限制（--N）	`rss top --15`
`list`	列出所有可用的 feed	没有任何	`rss list`
`--[feed-id]`	显示特定 feed 中的文章	可选限制（--N）	`rss --hackernews --10`
`[category]`	显示特定类别的文章	可选限制（--N）	`rss "Tech News" --20`
`set-feeds-path --[path]`	设置 OPML/JSON 文件的路径	文件路径	`rss set-feeds-path --/path/to/feeds.opml`

示例用法

以下是如何使用 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

实际工作流程

早晨例行事务：
rss top --10 rss "News" --5
行业研究：
rss "Industry News" --15 rss --bloomberg --5
技术更新：
rss --hackernews --10 rss --techcrunch --5

与克劳德合作

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

运行后： rss latest --10问：“你能总结一下这些文章吗？”
运行后： rss "Tech News" --15问：“这些科技文章中的关键趋势是什么？”
运行后： rss --nytimes --washingtonpost --10询问：“比较这些来源如何报道时事”

故障排除

“服务器断开连接”错误

如果您在 Claude Desktop 中看到错误“MCP RSS Aggregator：服务器已断开连接”：

验证服务器正在运行：
- 打开终端并从项目目录手动运行node build/index.js
- 如果服务器启动成功，则使用 Claude 并保持此终端打开
检查您的配置：
- 确保claude_desktop_config.json中的绝对路径对于您的系统来说是正确的
- 仔细检查 Windows 路径是否使用了双反斜杠 ( \\ )
- 验证您使用的文件系统根目录的完整路径

Claude 中未出现的工具

如果 RSS 聚合器工具没有出现在 Claude 中：

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

无法加载 Feed

如果您的订阅源无法正确加载：

确保您的 OPML/JSON 文件格式正确
检查配置中的feedsPath是否正确
尝试使用已知良好的 feed 文件手动运行服务器

贡献

欢迎为改进 RSS 聚合器做出贡献！您可以通过以下方式做出贡献：

添加对更多 feed 格式的支持
改进 feed 解析和错误处理
为文章添加更多可视化选项
提高分类和过滤能力

执照

该项目根据 Mozilla 公共许可证 2.0 获得许可 - 有关详细信息，请参阅LICENSE文件。

Integrations