Skip to main content
Glama

RSS MCP Server

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

  1. Clone the repository:
    git clone https://github.com/your-username/rss-mcp-server.git cd rss-mcp-server

Using uv

  1. Create and configure the environment file:
    cp .env.example .env
    Then, edit the .env file with your credentials.
  2. Sync dependencies:
    uv sync
  3. Run the server:
    uv run ./main.py

Using docker

  1. Configure docker-compose.yml: If needed, modify the port mapping in docker-compose.yml to avoid conflicts.
  2. Create and configure the environment file:
    cp .env.example .env
    Then, edit the .env file with your credentials.
  3. Build and run the container:
    docker compose up -d # or docker-compose up -d

Configuration

Copy a .env file in the root directory and edit the following variables:

# Replace with your FreshAPI credentials and URL GOOGLE_READER_EMAIL="alice" GOOGLE_READER_PASSWD="Abcdef123456" GOOGLE_READER_BASE_URL="https://freshrss.example.net/api/greader.php"

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/

快速开始

  1. 克隆仓库:
    git clone https://github.com/your-username/rss-mcp-server.git cd rss-mcp-server

使用 uv

  1. 创建并配置环境文件:
    cp .env.example .env
    然后,编辑 .env 文件并填入您的凭据。
  2. 同步依赖:
    uv sync
  3. 运行服务器:
    uv run ./main.py

使用 docker

  1. 配置 docker-compose.yml: 如果需要,请修改 docker-compose.yml 中的端口映射以避免冲突。
  2. 创建并配置环境文件:
    cp .env.example .env
    然后,编辑 .env 文件并填入您的凭据。
  3. 构建并运行容器:
    docker compose up -d # or docker-compose up -d

配置

在根目录中复制一个 .env 文件,并修改以下变量:

# Replace with your FreshAPI credentials and URL GOOGLE_READER_EMAIL="alice" GOOGLE_READER_PASSWD="Abcdef123456" GOOGLE_READER_BASE_URL="https://freshrss.example.net/api/greader.php"

注意: GOOGLE_READER_EMAIL 字段未必是电子邮件地址,它被用作与 FreshRSS API 进行身份验证的用户名。

免责声明

该 MCP 理论上适用于所有支持 FreshRSS API 的 RSS 阅读器,但仅在 Tiny Tiny RSS + FreshRSS API 上进行了测试。

-
security - not tested
A
license - permissive license
-
quality - not tested

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.

  1. Quickstart
    1. Using uv
    2. Using docker
  2. Configuration
    1. Disclaimer
      1. RSS MCP 服务器
        1. 快速开始
        2. 配置
        3. 免责声明

      Related MCP Servers

      • -
        security
        F
        license
        -
        quality
        Enables 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 -
        169
        117
        TypeScript
        • Apple
      • A
        security
        F
        license
        A
        quality
        Enables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.
        Last updated -
        3
        10
        1
        TypeScript
      • -
        security
        F
        license
        -
        quality
        Enables 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 -
        537
        47
        TypeScript
      • -
        security
        F
        license
        -
        quality
        An 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 -
        12
        TypeScript

      View all related MCP servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/xueli-sherryli/rss-mcp-server'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server