rss

本项目是一个适用于支持 FreshRSS API 的 RSS 服务的 MCP ( Model Context Protocol ) 服务器。该服务器允许您通过LLM与您的 RSS 阅读器进行交互。/ 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.

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

View docs

Command

claude mcp add --transport stdio xueli-sherryli-rss-mcp-server python ./main.py \
  --env GOOGLE_READER_EMAIL="your FreshRSS username" \
  --env GOOGLE_READER_PASSWD="your FreshRSS password" \
  --env GOOGLE_READER_BASE_URL="https://freshrss.example.net/api/greader.php"

How to use

This RSS MCP server provides an interface to interact with your RSS reader via the FreshRSS API through a conversation with an LLM. It exposes the RSS reading surface—such as retrieving feeds, folders, and items—and enables actions like marking items as read, saving favorites, or creating new entries, all while handling authentication against a FreshRSS-compatible backend. The server is designed to be compatible with any reader that supports the FreshRSS API, and is demonstrated here using the FreshRSS-style credentials and base URL configured in the .env file. To use it, configure your credentials, start the server via the recommended runner, and then issue model requests that map to RSS actions (e.g., fetch recent items, mark as read, or query by feed).

How to install

Prerequisites:

Python 3.8+ installed on your system
Access/credentials for a FreshRSS-compatible API
Optional: Docker if you prefer containerized deployment

Installation steps:

Clone the repository: git clone https://github.com/your-username/rss-mcp-server.git cd rss-mcp-server
Set up environment variables (recommended):
- Copy the example env file and edit with your credentials: cp .env.example .env
  Edit .env to include your FreshRSS API details
Install Python dependencies (if any are specified in requirements.txt or pyproject.toml):

Example with pip

python -m pip install -r requirements.txt
Run the server directly (uv style workflow shown in README): uv sync uv run ./main.py
Optional: run with Docker
- Ensure docker is installed
- Build and start containers as described in the README

Note: If you are using Docker, you can customize docker-compose.yml as needed to map ports appropriately.

Additional notes

Tips and common issues:

Ensure GOOGLe_READER_BASE_URL points to a valid FreshRSS API endpoint accessible from your environment.
The GOCCE_ variables in the README are placeholders; replace them with real credentials before starting the server.
If you modify .env, you may need to restart the MCP server for changes to take effect.
The server aims for compatibility with FreshRSS API-backed readers; if you use a different RSS backend, verify that the API endpoints align with expectations.
When running with Docker, ensure the environment file is copied into the container if the container expects .env at startup.

Related MCP Servers

mcp-vegalite

MCP server from isaacwasserman/mcp-vegalite-server

github-chat

A Model Context Protocol (MCP) for analyzing and querying GitHub repositories using the GitHub Chat API.

nautex

MCP server for guiding Coding Agents via end-to-end requirements to implementation plan pipeline

pagerduty

PagerDuty's official local MCP (Model Context Protocol) server which provides tools to interact with your PagerDuty account directly from your MCP-enabled client.

futu-stock

mcp server for futuniuniu stock

mcp -boilerplate

Boilerplate using one of the 'better' ways to build MCP Servers. Written using FastMCP

rss