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 上進行了測試。