MCP RSS

MCP RSS 是一个用于与 RSS 源交互的 Model Context Protocol (MCP) 服务器。

功能

• 解析 OPML 文件以导入 RSS 源订阅
• 自动从 RSS 源获取并更新文章
• 通过 MCP API 暴露 RSS 内容
• 将文章标记为收藏
• 按来源和状态过滤文章

安装

前提条件

• Node.js (v14 或更高版本)
• MySQL 数据库

设置 MySQL

$ docker run -itd --name mysql-test -p 3306:3306 -e MYSQL_ROOT_PASSWORD=123456 mysql

安装 MCP

此 MCP 使用 stdio 进行通信。在命令中填写 npx mcp_rss，在环境变量中填写需要自定义的配置，并至少使用你自己的 opml 文件。

在 claude 桌面中使用

{
  "key": "rss",
  "command": "npx",
  "args": [
    "mcp_rss"
  ],
  "env": {
    "OPML_FILE_PATH": "/Users/guyanhua/feeds.opml"
  }
}

配置

设置以下环境变量以配置 MCP RSS：

配置选项

选项	描述	默认值
DB_HOST	数据库主机	localhost
DB_PORT	数据库端口	3306
DB_USERNAME	数据库用户名	root
DB_PASSWORD	数据库密码	123456
DB_DATABASE	数据库名称	mcp_rss
OPML_FILE_PATH	包含 RSS 源的 OPML 文件路径	"./feeds.opml"
RSS_UPDATE_INTERVAL	获取 RSS 更新的时间间隔（分钟）	1

MCP API 参考

MCP RSS 服务器公开了以下 API 方法：

get_content

从订阅的 RSS 源获取文章。

参数：

参数	类型	描述	必填
status	string	按文章状态筛选（"normal" 或 "favorite"）	否
source	string	按来源筛选（源标题）	否
limit	number	返回的最大文章数量	否（默认: 10）

响应：

{
  "articles": [
    {
      "id": 1,
      "title": "Article Title",
      "content": "Article content...",
      "link": "https://example.com/article",
      "pubDate": "2023-01-01T12:00:00Z",
      "fetchDate": "2023-01-01T12:30:00Z",
      "status": "normal",
      "feedTitle": "Example Feed",
      "feedCategory": "Technology"
    }
  ],
  "success": true
}

get_sources

获取所有可用的 RSS 源。

参数： 无

响应：

{
  "sources": [
    {
      "id": 1,
      "title": "Example Feed",
      "category": "Technology"
    }
  ],
  "success": true
}

set_tag

设置文章的状态（正常或收藏）。

参数：

参数	类型	描述	必填
status	string	文章状态（"normal" 或 "favorite"）	是
articleId	number	要更新的文章 ID	是

响应：

{
  "success": true,
  "message": "Article 1 status has been updated to favorite"
}

许可证

MIT