MCP Rss

🚀 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 許可證。