Rss MCP

🚀 RSS MCP 服務器

這是一個使用 TypeScript 構建的模型上下文協議（MCP）服務器。它提供了一個通用工具，可用於獲取和解析任何標準的 RSS/Atom 訂閱源，還對 RSSHub 訂閱源提供了特殊支持。藉助此服務器，語言模型或其他 MCP 客戶端可以輕鬆從各種網絡源獲取結構化內容。

服務器內置了一份公共 RSSHub 實例列表，並支持輪詢機制以自動選擇可用實例，顯著提高了數據獲取的成功率和穩定性。

✨ 主要特性

• 通用訂閱源解析：從給定的 URL 獲取並解析任何標準的 RSS/Atom 訂閱源。
• 增強的 RSSHub 支持：提供了一個名為 get_feed 的工具，可通過 MCP 獲取任何 RSSHub 支持的訂閱源，並支持多實例。
• 多實例支持：包含一份公共 RSSHub 實例列表，並自動輪詢以找到可用服務。
• 智能 URL 解析：支持標準的 RSSHub URL 和簡化的 rsshub:// 協議格式。
• 優先實例配置：允許通過 PRIORITY_RSSHUB_INSTANCE 環境變量設置首選的 RSSHub 實例。
• 強大的錯誤處理：如果對一個實例的請求失敗，它會自動嘗試下一個實例，直到成功或所有實例都失敗。
• 內容清理：使用 Cheerio 清理訂閱源內容並提取純文本描述。
• 標準化輸出：將獲取的 RSS 訂閱源轉換為結構化的 JSON 格式。

📦 安裝指南

首先，克隆項目倉庫，然後安裝所需的依賴項。

git clone <your-repo-url>
cd rss-mcp
npm install

🚀 快速開始

1. 構建項目

在運行之前，你需要將 TypeScript 代碼編譯為 JavaScript：

npm run build

2. 啟動服務器

構建成功後，啟動 MCP 服務器：

npm start

服務器隨後將通過標準輸入輸出與父進程（例如 Cursor）進行通信。

3. 配置優先實例（可選）

你可以創建一個 .env 文件來指定優先的 RSSHub 實例。這對於擁有私有、穩定實例的用戶非常有用。 在項目根目錄下創建一個 .env 文件，並添加以下內容：

PRIORITY_RSSHUB_INSTANCE=https://my-rsshub.example.com

服務器將在啟動時自動加載此配置，並將其置於輪詢列表的頂部。

🔧 MCP 服務器配置

要將此服務器與像 Cursor 這樣的 MCP 客戶端一起使用，你需要將其添加到配置文件中。

方法 1：使用 npx（推薦）

如果該軟件包已發佈到 npm，你可以使用 npx 來運行服務器，而無需本地安裝。這是最簡單的方法。

1. 找到你的 MCP 配置文件（例如 ~/.cursor/mcp_settings.json）。
2. 添加以下服務器條目：

{
  "name": "rss",
  "command": ["npx", "rss-mcp"],
  "type": "stdio"
}

方法 2：本地安裝

如果你已在本地克隆了倉庫，你可以直接使用 node 運行它。

1. 克隆並構建項目，如“安裝指南”和“快速開始”部分所述。
2. 找到你的 MCP 配置文件。
3. 添加以下服務器條目，並確保使用編譯後的 index.js 文件的絕對路徑：

{
  "name": "rss",
  "command": ["node", "/path/to/your/rss-mcp/dist/index.js"],
  "type": "stdio"
}

重要提示：將 /path/to/your/rss-mcp/dist/index.js 替換為你係統上的正確絕對路徑。

添加配置後，重啟你的 MCP 客戶端（例如 Cursor）以使更改生效。rss 服務器隨後將可用，你可以調用 get_feed 工具。

💻 使用示例

get_feed

從給定的 URL 獲取並解析 RSS 訂閱源。它支持標準的 RSS/Atom 訂閱源和 RSSHub 訂閱源。

輸入參數

• url（字符串，必需）：要獲取的 RSS 訂閱源的 URL。支持兩種格式：
  1. 標準 URL：https://rsshub.app/bilibili/user/dynamic/208259
  2. rsshub:// 協議：rsshub://bilibili/user/dynamic/208259（服務器將自動匹配可用實例）

輸出

返回一個包含訂閱源信息的 JSON 字符串，結構如下：

{
  "title": "bilibili User Dynamics",
  "link": "https://space.bilibili.com/208259",
  "description": "bilibili User Dynamics",
  "items": [
    {
      "title": "[Dynamic Title]",
      "description": "Plain text content of the dynamic...",
      "link": "https://t.bilibili.com/1234567890",
      "guid": "https://t.bilibili.com/1234567890",
      "pubDate": "2024-05-20T12:30:00.000Z",
      "author": "Author Name",
      "category": ["Category1", "Category2"]
    }
  ]
}

📚 詳細文檔

主要依賴項

📄 許可證

本項目採用 Apache 2.0 許可證。