🚀 MCP RSS 服务器

MCP RSS 是一个基于 Model Context Protocol (MCP) 的服务器，主要用于与 RSS 源进行交互。它能够解析 OPML 文件来导入 RSS 订阅源，自动获取并更新文章，还能通过 MCP API 暴露 RSS 内容，方便用户对文章进行管理和筛选。

🚀 快速开始

MCP RSS 服务器可帮助你轻松管理 RSS 订阅源，获取和更新文章。以下是使用该服务器的基本步骤：

1. 完成安装所需的先决条件，如安装 Node.js 和 MySQL 数据库。
2. 按照安装说明进行 MySQL 数据库的设置和 MCP 的安装。
3. 根据配置说明设置环境变量，以满足你的个性化需求。
4. 利用 MCP API 参考中的 API 方法，获取文章、RSS 源信息以及设置文章状态。

✨ 主要特性

• OPML 文件解析：可解析 OPML 文件，方便导入 RSS 订阅源。
• 文章自动更新：自动获取并更新 RSS 源中的文章。
• API 内容暴露：通过 MCP API 暴露 RSS 内容，便于外部调用。
• 文章收藏标记：支持将文章标记为收藏。
• 文章过滤功能：可按来源和状态过滤文章。

📦 安装指南

先决条件

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

设置 MySQL

使用 Docker 运行 MySQL 数据库：

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

安装 MCP

此 MCP 使用标准输入输出进行通信。在控制台中输入 npx mcp_rss，并在环境变量中填写需要自定义的配置信息，且至少使用您自己的 OPML 文件。

用于 Claude 桌面的配置示例：

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

📚 详细文档

配置说明

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

MCP API 参考

MCP RSS 服务器暴露以下 API 方法：

get_content

从订阅的 RSS 源获取文章。 参数：

响应：

{
  "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": "示例源",
      "feedCategory": "技术"
    }
  ],
  "success": true
}

get_sources

获取所有可用的 RSS 源。 参数： 无

响应：

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

set_tag

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

响应：

{
  "success": true,
  "message": "文章 1 的状态已更改为收藏"
}

📄 许可证

本项目采用 MIT 许可证。