Enables interaction with RSS readers that support the FreshRSS API, allowing LLMs to read and manage RSS feeds through the Google Reader-compatible API
RSS MCP Server
This project is an MCP ( Model Context Protocol ) server for RSS services that support the FreshRSS API. This server allows you to interact with your RSS reader through LLM.
This project and its documentation were created by Gemini with human review, based on the original documentation at https://xueli-sherryli.github.io/friendlier-fresh-rss-api-doc/.
Quickstart
- Clone the repository:
Using uv
- Create and configure the environment file:Then, edit the
.env
file with your credentials. - Sync dependencies:
- Run the server:
Using docker
- Configure
docker-compose.yml
: If needed, modify the port mapping indocker-compose.yml
to avoid conflicts. - Create and configure the environment file:Then, edit the
.env
file with your credentials. - Build and run the container:
Configuration
Copy a .env
file in the root directory and edit the following variables:
Note: The GOOGLE_READER_EMAIL
field is not necessarily an email address. It is used as the username for authentication with the FreshRSS API.
Disclaimer
This MCP is designed to be compatible with any RSS reader that supports the FreshRSS API. However, it has only been tested with Tiny Tiny RSS + FreshRSS API.
RSS MCP 服务器
本项目是一个适用于支持 FreshRSS API 的 RSS 服务的 MCP ( Model Context Protocol ) 服务器。该服务器允许您通过LLM与您的 RSS 阅读器进行交互。
本项目及其文档由 Gemini 在人工审阅下创建,基于原始文档 https://xueli-sherryli.github.io/friendlier-fresh-rss-api-doc/。
快速开始
- 克隆仓库:
使用 uv
- 创建并配置环境文件:然后,编辑
.env
文件并填入您的凭据。 - 同步依赖:
- 运行服务器:
使用 docker
- 配置
docker-compose.yml
: 如果需要,请修改docker-compose.yml
中的端口映射以避免冲突。 - 创建并配置环境文件:然后,编辑
.env
文件并填入您的凭据。 - 构建并运行容器:
配置
在根目录中复制一个 .env
文件,并修改以下变量:
注意: GOOGLE_READER_EMAIL
字段未必是电子邮件地址,它被用作与 FreshRSS API 进行身份验证的用户名。
免责声明
该 MCP 理论上适用于所有支持 FreshRSS API 的 RSS 阅读器,但仅在 Tiny Tiny RSS + FreshRSS API 上进行了测试。
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables interaction with RSS readers that support the FreshRSS API through natural language. Allows users to manage and query their RSS feeds and articles via LLM conversations.
Related MCP Servers
- -securityFlicense-qualityEnables LLMs to interact with Discord channels by sending and reading messages through Discord's API, with a focus on maintaining user control and security.Last updated -169117TypeScript
- AsecurityFlicenseAqualityEnables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.Last updated -3101TypeScript
- -securityFlicense-qualityEnables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.Last updated -53747TypeScript
- -securityFlicense-qualityAn MCP server that fetches RSS feeds and shares them with LLMs, allowing AI assistants to access and present the latest news and articles from configured feeds.Last updated -12TypeScript