MCP RSS

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 desktop 中使用

{
  "command": "npx",
  "args": [
    "mcp_rss"
  ],
  "env": {
    "OPML_FILE_PATH": "/PATH/YOUR_FEED_FILE.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

设置文章状态（normal 或 favorite）。

参数：

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

响应：

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

许可证

MIT