RSS协议服务器

MCP RSS是一个基于Model Context Protocol (MCP)的RSS订阅服务器,用于解析、管理和提供RSS订阅内容。

  • by xrusjohn
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 xrusjohn/mcp_rss_buhe

使用说明

MCP RSS

MCP RSS是一个用于与RSS提要交互的模型上下文协议(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 数据库主机 本地主机
DB_PORT 数据库端口 3306
DB_USENAME 数据库用户名 root
DB_PASSWORD 数据库密码 123456
DB_DATABASE 数据库名称 mcp_rss
OPML_FILE_PATH 带有RSS提要的OPML文件的路径 “./feeds.OPML”
RSS_UPDATEINTERVAL 获取RSS更新的间隔(分钟) 1

MCP API参考

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

get_content

从订阅的RSS源获取文章。

参数:

参数 类型 说明 必填
status string 按文章状态筛选(“正常”或“收藏”) 否
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
}

获取_资源

获取所有可用的RSS源。

参数: 无

答复:

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

set_tag

设置文章的状态(正常或收藏)。

参数:

参数 类型 说明 必填
status string 文章状态(“正常”或“收藏”) 是
articleId 编号 要更新的文章的ID 是

答复:

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

许可证

麻省理工学院