项目简介

这是一个基于 FastMCP 框架实现的 MCP 服务器，用于连接支持 Fever API 的 RSS 服务端（如 Fever、FreshRSS、Nextcloud News with Fever plugin 等），并将 RSS 订阅源、分组、文章等数据和标记文章状态的功能通过 Model Context Protocol (MCP) 暴露给兼容的 LLM 客户端，作为 LLM 应用的上下文和工具来源。

主要功能点

获取订阅源及分组： 允许 LLM 客户端获取用户在 Fever API 后端配置的所有 RSS 订阅源及其分组信息。
获取文章列表： 支持按多种条件（未读、已保存、指定 ID 后、指定订阅源 ID、指定分组 ID）获取 RSS 文章列表。
文章详情： 提供文章的标题、URL、内容（HTML 格式）、发布时间、作者、媒体附件等详细信息。
标记文章状态： 允许 LLM 客户端标记文章为已读、已保存或取消保存。
提供应用版本信息： 暴露服务器自身的版本号作为配置资源。

安装步骤

克隆项目仓库到本地。

git clone https://github.com/weekend-project-space/rss-mcp-server.git
cd rss-mcp-server

安装 Python 依赖。

pip install -r requirements.txt

配置服务器参数。
- 复制 '.env.example' 文件到 '.env'。
```
cp .env.example .env
```
- 编辑 '.env' 文件，根据你的 Fever API 服务信息填写以下配置项：
  - 'FEVER_API_URL': 你的 Fever API 端点 URL。
  - 'FEVER_USERNAME': 你的 Fever API 用户名。
  - 'FEVER_PASSWORD': 你的 Fever API 密码。
  - 'MCP_SERVER_NAME': 为此 MCP 服务器实例设置一个名称（例如 'rss-mcp-server'）。

服务器配置 (MCP 客户端配置)

要让 MCP 客户端（如 Cursor）连接到此服务器，你需要在客户端的 MCP 配置文件中添加此服务器的信息。典型的配置路径是 '~/.cursor/mcp.json'（具体位置和格式可能因客户端而异）。

你需要添加一个服务器条目，指定一个唯一的名称以及服务器的连接 URL。此服务器默认通过 SSE 协议在本地的 8000 端口提供服务，其 SSE 端点通常为 '/sse'。

以下是 Cursor 客户端配置示例结构 (JSON 格式):

{
  "mcpServers": {
    "你的服务器名称": { // 你可以在这里给服务器起一个易于识别的名称
      "url": "连接此 MCP 服务器的 URL" // 对于本地运行的情况，填写 "http://127.0.0.1:8000/sse"
      // 根据客户端需要，可能还有其他可选参数，如 "enabled": true
    }
    // 可以配置多个 MCP 服务器
  }
}

将 '"你的服务器名称"' 替换为你想要的名称，将 '"连接此 MCP 服务器的 URL"' 替换为服务器实际运行的地址和端口，通常是 'http://127.0.0.1:8000/sse' 如果你在本地运行并使用默认端口。

基本使用方法

在完成安装和配置后，运行以下命令启动 MCP 服务器：

python main.py

服务器启动后，你的 MCP 客户端（如果已正确配置）应该就能连接到此服务器，并能够通过 LLM 访问你 Fever API 后端提供的 RSS 数据和功能。

关键词

信息