Rss MCP Server

🚀 RSS MCP 服务器

本项目是一个适用于支持 FreshRSS API 的 RSS 服务的 MCP（Model Context Protocol）服务器，借助它，你能够通过大语言模型（LLM）与 RSS 阅读器进行交互。本项目及其文档由 Gemini 在人工审阅下创建，基于原始文档 https://xueli-sherryli.github.io/friendlier-fresh-rss-api-doc/。

🚀 快速开始

克隆仓库

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 上进行了测试。