MCP RSS

MCP RSS 是一个用于与 RSS feeds 交互的模型上下文协议 (MCP) 服务器。

功能

• 解析 OPML 文件以导入 RSS feed 订阅
• 自动从 RSS feeds 获取和更新文章
• 通过 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 中使用

{
  "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 feeds 的 OPML 文件路径	"./feeds.opml"
RSS_UPDATE_INTERVAL	获取 RSS 更新的间隔（分钟）	1

MCP API 参考

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

get_content

从订阅的 RSS feeds 获取文章。

参数：

参数	类型	描述	是否必需
status	string	按文章状态过滤（“normal” 或 “favorite”）	否
source	string	按来源（feed 标题）过滤	否
limit	number	要返回的最大文章数	否 (默认: 10)

响应：

{
  "articles": [
    {
      "id": 1,
      "title": "文章标题",
      "content": "文章内容...",
      "link": "https://example.com/article",
      "pubDate": "2023-01-01T12:00:00Z",
      "fetchDate": "2023-01-01T12:30:00Z",
      "status": "normal",
      "feedTitle": "示例 Feed",
      "feedCategory": "技术"
    }
  ],
  "success": true
}

get_sources

获取所有可用的 RSS feed 来源。

参数： 无

响应：

{
  "sources": [
    {
      "id": 1,
      "title": "示例 Feed",
      "category": "技术"
    }
  ],
  "success": true
}

set_tag

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

参数：

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

响应：

{
  "success": true,
  "message": "文章 1 的状态已更新为 favorite"
}

许可证

MIT