RSS Reader MCP Server

RSS 阅读器 MCP 服务

一个基于 TypeScript 的 MCP 服务，可从 URL 获取并解析 RSS/Atom 订阅源，提供 RSS 订阅源阅读功能。

概述

此 MCP 服务通过提供获取、解析 RSS 和 Atom 订阅源并从中提取结构化数据的工具，实现 RSS 订阅源阅读功能。它使用 rss-parser 库可靠地解析订阅源，并使用 axios 发起 HTTP 请求，同时提供完善的错误处理和超时控制。

功能

工具

• get_items - 从指定 URL 获取 RSS 订阅源条目
  • 输入：RSS 订阅源 URL（必填）
  • 输出：包含订阅源元数据和条目的结构化 JSON
  • 功能：
    • 获取 RSS/Atom 订阅源，超时时间为 10 秒
    • 解析标准 RSS 字段（title、link、description、pubDate、author 等）
    • 提取自定义字段（媒体内容、缩略图、编码内容）
    • 处理分类和媒体附件
    • 全面处理网络和解析问题

支持的订阅源格式

• RSS 2.0
• RSS 1.0（RDF）
• Atom 订阅源
• 自定义字段，包括：
  • 媒体内容和缩略图
  • Dublin Core creator 字段
  • Content-encoded 字段

错误处理

• URL 验证
• 网络超时处理（10 秒）
• HTTP 错误状态处理
• RSS 解析错误处理
• 提供全面的错误消息，便于调试

开发

安装依赖项：

npm install

构建服务：

npm run build

启用自动重新构建以进行开发：

npm run watch

安装

若要与 Claude Desktop 配合使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rss-reader-server": {
      "command": "node",
      "args": ["/path/to/rss-reader-server/build/index.js"]
    }
  }
}

使用示例

连接后，可以使用 get_items 工具获取 RSS 订阅源条目：

Tool: get_items
Input: { "url": "https://example.com/feed.xml" }

服务将返回结构化 JSON 响应，其中包含：

• 订阅源 URL
• 条目总数
• 订阅源条目数组，包括：
  • 标题、链接、描述
  • 发布日期和作者
  • 分类（如有）
  • 媒体附件信息（适用于播客/媒体）

依赖项

• @modelcontextprotocol/sdk：MCP 协议实现
• rss-parser：RSS/Atom 订阅源解析
• axios：用于获取订阅源的 HTTP 客户端
• zod：运行时类型验证

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

错误响应

服务会针对常见问题提供详细的错误消息：

• URL 格式无效
• 网络连接问题
• HTTP 错误（404、500 等）
• 请求超时
• RSS 解析失败

所有错误都会以结构化格式返回，并附有描述性消息，帮助排查问题。