mcp_rss

🚀 MCP RSS 服务器

MCP RSS 是一个基于 Model Context Protocol (MCP) 的服务器，主要用于与 RSS 源进行交互，能帮助用户高效管理 RSS 订阅内容。

✨ 主要特性

• 支持解析 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 使用标准输入输出进行通信。在控制台中输入 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 | OPML 文件路径 | "./feeds.opml" | | RSS_UPDATE_INTERVAL | 更新间隔时间（分钟） | 1 |

MCP API 参考

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

get_content

从订阅的 RSS 源获取文章。

参数：

| 参数 | 类型 | 描述 | 是否必需 | |----------|--------|------------------------|----------| | status | string | 根据文章状态过滤（"normal" 或 "favorite"） | 否 | | source | string | 根据来源过滤 | 否 | | 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": "示例源",
      "feedCategory": "技术"
    }
  ],
  "success": true
}

get_sources

获取所有可用的 RSS 源。

参数： 无

响应：

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

set_tag

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

参数：

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

响应：

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

📄 许可证

MIT