kwp-lab-rss-reader-mcp

RSS 阅读器 MCP

用于 RSS 订阅聚合和文章内容提取的 MCP（Model Context Protocol）服务。你可以用它订阅 RSS 订阅源并获取文章列表，也可以从 URL 提取文章的完整内容并将其格式化为 Markdown。

English | 中文

🚀 快速开始

你可以在支持 MCP 的客户端（例如 Claude Desktop 和 CherryStudio）中使用此 MCP 服务。

Claude Desktop

对于 Claude Desktop，请在 claude_desktop_config.json 文件的 "mcpServers" 部分添加以下配置：

{
  "mcpServers": {
    "rss-reader": {
      "command": "npx",
      "args": [
        "-y",
        "rss-reader-mcp"
      ]
    }
  }
}

使用示例

• 获取 RSS 订阅源的基本信息

  能否获取 BBC News RSS 订阅源的最新 5 条头条？ URL：https://feeds.bbci.co.uk/news/rss.xml

• 提取文章完整内容

  请提取这篇文章的完整内容并将其格式化为 Markdown： https://example.com/news/article-title

🔧 工具参考

fetch_feed_entries

从指定 URL 获取 RSS 条目

参数：

• url（必填字符串）：RSS 订阅源 URL
• limit（可选数字）：返回条目的最大数量（默认值为 10，最大值为 100）

**返回：**包含订阅源元数据和条目列表的 JSON 对象（包括标题、链接、发布日期和摘要）

fetch_article_content

从 URL 提取文章内容并将其格式化为 Markdown

参数：

• url（必填字符串）：文章 URL

**返回：**包含标题、Markdown 内容、源 URL 和时间戳的 JSON 对象

⚙️ 传输方式和环境变量

此服务支持两种传输方式：

• stdio（默认）：通过标准输入/输出进行通信。适用于运行本地进程的客户端，例如 Claude Desktop。
• httpStream：通过 HTTP 流式传输进行通信。适用于支持 HTTP(S) 传输的客户端或容器化部署。

可用的环境变量：

• TRANSPORT：选择传输方式，可设为 stdio（默认）或 httpStream。
• PORT：当 TRANSPORT=httpStream 时，设置监听端口（默认值为 8081）。
• MCP_SERVER_HOST：当 TRANSPORT=httpStream 时，设置监听地址（默认值为 localhost）。在 Docker 中，将其设为 0.0.0.0 以向外部开放端口。

如何切换传输方式：

• 使用 stdio（无需额外设置，默认方式）：
  • 通过 command + args 配置与 Claude Desktop 配合使用（参见上方示例）。
• 使用 httpStream：
  • 设置环境变量 TRANSPORT=httpStream 并指定 PORT（若未设置，默认值为 8081）。
  • 在容器中运行时，还要设置 MCP_SERVER_HOST=0.0.0.0 并映射端口。
  • 此仓库中的 Dockerfile 已包含相关环境变量设置。

Docker 部署

你也可以在 Docker 容器中运行此 MCP 服务。首先，在项目根目录构建镜像：

docker build -t rss-reader-mcp .

以下配置以 CherryStudio 为例，展示如何通过 HTTP 运行此服务：

{
  "mcpServers": {
    "rss-reader-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "8081:8081",
        "-e",
        "PORT=8081",
        "rss-reader-mcp"
      ]
    }
  }
}

用于测试的 RSS 订阅源

• BBC News： https://feeds.bbci.co.uk/news/rss.xml
• TechCrunch： https://techcrunch.com/feed/
• Hacker News： https://hnrss.org/frontpage
• MIT Technology Review： https://www.technologyreview.com/feed/