JinDaGe - mcp-rss MCP Details

article

README

🚀 MCP - RSS 服务器

MCP - RSS 服务器是一个基于模型上下文协议（MCP）的服务器，用于获取、解析和管理 RSS 订阅源。它能帮助用户高效地处理各类 RSS 数据，提升信息获取与管理的效率。

✨ 主要特性

抓取并解析 RSS/Atom 订阅源。
具备带 TTL 的内存缓存功能。
支持批量获取多个订阅源。
可监控订阅源的新内容。
能在多个订阅源中搜索内容。
提取并格式化订阅源内容。
支持将订阅的源导出为 OPML 格式。

🚀 快速开始

安装

使用以下命令进行安装：

yarn add @missionsquad/mcp - rss
npm install @missionsquad/mcp - rss

前提条件

Node.js v20 或更高版本。
npm 或 yarn。

配置与启动

安装依赖：

yarn

配置环境：
- 将 .env.example 复制为 .env。
- 编辑 .env 文件，设置必要的环境变量。
构建项目：

yarn build

启动服务器：

yarn start

💻 使用示例

基础用法

以下是一些常用工具的使用示例：

// 抓取并解析单个 RSS 订阅源
const { fetch_rss_feed } = require('@missionsquad/mcp-rss');
fetch_rss_feed('https://example.com/rss.xml')
  .then(feed => console.log(feed))
  .catch(error => console.error(error));

// 并行或顺序抓取多个 RSS 订阅源
const { fetch_multiple_feeds } = require('@missionsquad/mcp-rss');
const feedUrls = ['https://example1.com/rss.xml', 'https://example2.com/rss.xml'];
fetch_multiple_feeds(feedUrls)
  .then(feeds => console.log(feeds))
  .catch(error => console.error(error));

高级用法

// 监控订阅源自特定时间以来的新内容
const { monitor_feed_updates } = require('@missionsquad/mcp-rss');
const sinceTime = new Date('2024-01-01');
monitor_feed_updates('https://example.com/rss.xml', sinceTime)
  .then(newItems => console.log(newItems))
  .catch(error => console.error(error));

// 在一个或多个 RSS 订阅源中搜索内容
const { search_feed_items } = require('@missionsquad/mcp-rss');
const searchTerm = 'keyword';
search_feed_items([ 'https://example1.com/rss.xml', 'https://example2.com/rss.xml' ], searchTerm)
  .then(results => console.log(results))
  .catch(error => console.error(error));

📚 详细文档

可用工具

fetch_rss_feed：抓取并解析单个 RSS 订阅源。
fetch_multiple_feeds：并行或顺序抓取多个 RSS 订阅源。
monitor_feed_updates：检查自特定时间以来订阅源中的新内容。
search_feed_items：在一个或多个 RSS 订阅源中搜索内容。
extract_feed_content：从订阅源项中提取并格式化内容，支持 json、markdown、html 和 text 格式。
get_feed_headlines：获取订阅源的标题列表，支持 json、markdown、html 和 text 格式。

可用资源

rss://cache/{feedUrl}：访问缓存的订阅源数据。
rss://opml/export：以 OPML 格式导出所有监控的订阅源。

配置

通过 .env 文件中定义的环境变量来配置服务器。所有可用选项请参考 .env.example 文件。

🔍 在 Mission Squad 上试用

你可以在 Mission Squad 平台上测试 mcp - rss 服务器和其他 MCP 服务器。Mission Squad 是一个智能 AI 平台，允许你构建、管理和部署连接到任何模型、利用私有数据并自动化复杂任务的协作代理。注册一个免费账户即可开始使用。

mcp-rss