RSS订阅管理服务器

RSS MCP服务器

中文文档

使用Fever API管理RSS提要的FastMCP服务器实现。

安装

1. 克隆存储库
2. 安装依赖项：

pip install -r requirements.txt

配置

1. 复制 .env.example 向 .env:

cp .env.example .env

2. 编辑 .env 并设置配置值：

• FEVER_API_URL：Fever API端点的URL
• FEVER_USERNAME：您的Fever API用户名
• FEVER_PASSWORD：您的Fever API密码
• MCP_SERVER_NAME：MCP服务器实例的名称

3. 配置游标集成：

在以下位置创建或编辑Cursor MCP配置文件 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "RssMcpServer": {
      "url": "http://127.0.0.1:8000/sse"
    }
  }
}

此配置将允许Cursor连接到在端口8000上本地运行的RSS MCP服务器。

运行服务器

使用以下命令启动服务器：

python main.py

API工具

服务器提供以下MCP工具：

饲料管理

• get_feeds()：检索所有RSS源
• get_groups()：检索所有订阅源组

项目操作

• get_unread_items(max_items=10, max_id=9999999999, since_id="", feed_ids=None, group_ids=None)：获取未读项目
• get_saved_items(max_items=10, max_id=9999999999)：获取已保存/收藏的项目
• get_items(since_id="")：从特定ID获取项目
• get_items_by_feed_ids(feed_ids, max_items=10)：从特定提要中获取项目
• get_items_by_group_ids(group_ids, max_items=10)：从特定组中获取项目
• mark_item(item_id, action)：将项目标记为已读/已保存/未保存

依赖项

• 星宿>=0.27.0
• 请求>=2.31.0
• python dotenv>=1.0.0
• fastmcp>=0.1.0
• uvicorn>=0.24.0

许可证

MIT许可证