Skip to content

README_zh.md

Latest commit

 

History

History
124 lines (87 loc) · 3.83 KB

README_zh.md

File metadata and controls

124 lines (87 loc) · 3.83 KB

RSS Reader MCP

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

English | 中文

npm version license build status smithery badge

🚀 快速开始

你可以在MCP客户端（如Claude Desktop、CherryStudio等）中使用此 MCP 服务器。

Claude Desktop

对于 Claude Desktop，你需要在 claude_desktop_config.json 文件的 “mcpServers” 部分添加以下配置信息：

{
  "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 Desktop 等使用本地进程的客户端。
  • httpStream：通过 HTTP 流进行通信，适合支持 HTTP(S) 传输的客户端或容器化部署。

可用环境变量：

  • TRANSPORT：选择传输方式，取值为 stdio（默认）或 httpStream。
  • PORT：当 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镜像：

docker build -t rss-reader-mcp .

使用 CherryStudio 为例，下面的示例展示了如何使用 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
  • MIT科技评论： https://www.technologyreview.com/feed/