RSS阅读器MCP

一个用于RSS订阅和文章内容提取的MCP服务器,支持获取文章列表和将文章内容格式化为Markdown。

  • by kwp-lab
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 kwp-lab/rss-reader-mcp

使用说明

RSS阅读器MCP

一个用于RSS订阅聚合和文章内容提取的MCP(模型上下文协议)服务器。您可以使用它来订阅RSS订阅源并获取文章列表,或者从URL中提取文章的完整内容,并将其格式化为Markdown。

英语 | 中文

🚀 快速入门

您可以在支持MCP的客户端中使用此MCP服务器,例如 Claude Desktop(可译为“Claude桌面版”或保持原样,根据语境决定是否需要意译) 并且 CherryStudio(樱桃工作室).

Claude Desktop(可译为“Claude桌面版”或根据具体语境简化为“Claude桌面”)

对于 Claude Desktop,请在您的配置文件中“mcpServers”部分下添加以下配置 claude_desktop_config.json 文件:

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

使用示例

🔧 工具参考

fetch_feed_entries

从指定的URL获取RSS条目

参数:

  • url (必填字符串):RSS订阅源URL
  • limit (可选数字):要返回的条目最大数量(默认10,最大100)

返回值: 一个包含订阅元数据和条目列表(包括标题、链接、发布日期和摘要)的JSON对象

fetch_article_content

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

参数:

  • url (必填字符串):文章URL

返回值: 一个包含标题、Markdown 内容、来源 URL 和时间戳的 JSON 对象

⚙️ 传输与环境变量

此服务器支持两种传输模式:

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

可用的环境变量:

  • 传输:选择传输模式,可选 stdio (默认)或 httpStream.
  • 端口:当 TRANSPORT=httpStream,监听端口(默认 8081)。
  • MCP_SERVER_HOST:当 TRANSPORT=httpStream,监听地址(默认 localhost)。 在Docker中,将此设置为 0.0.0.0 将端口暴露给外部。

如何切换交通方式:

  • 使用 stdio(无需额外设置,默认配置):
    • 通过与Claude Desktop配合使用 command + args 配置(见上例)。
  • 使用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新闻: https://feeds.bbci.co.uk/news/rss.xml
  • TechCrunch:(科技媒体或博客名称,直译为“科技评论”) https://techcrunch.com/feed/
  • 黑客新闻(Hacker News): https://hnrss.org/frontpage
  • 《麻省理工科技评论》 https://www.technologyreview.com/feed/