使用说明

项目简介

Zenfeed 是一款基于 MCP 协议构建的智能信息助手，它可以自动化地从 RSS 订阅源中收集、筛选和总结信息，并提供每日简报、监控等功能。作为一个 MCP 服务器，Zenfeed 旨在为 LLM 客户端提供结构化的上下文信息和工具能力，帮助 LLM 更好地理解和处理信息。

主要功能点

资源管理 (Resources): Zenfeed 托管和管理 RSS 订阅源抓取的新闻或话题信息，作为 LLM 可以访问和利用的结构化数据资源。
数据访问能力: 通过 MCP 协议，LLM 客户端可以请求访问和查询 Zenfeed 管理的 feed 数据，例如获取特定主题或时间范围内的信息。
Prompt 模板 (Prompts): Zenfeed 支持通过 Prompt 模板自定义内容处理管道，允许用户灵活地编排内容处理流程，例如内容摘要、分类、过滤和标签添加等，从而为 LLM 提供定制化的上下文信息。
智能化信息处理: 内置 AI 内容处理能力，可以对 feed 内容进行智能分析、筛选和总结，例如使用 LLM 模型进行内容摘要和分类。
个性化信息推送: 支持每日简报和监控功能，可以根据用户配置定时推送个性化的信息摘要和通知。
Web 管理界面: 提供 Web 界面 (zenfeed-web) 用于订阅源管理、配置简报和监控等，方便用户操作和管理 Zenfeed 服务器。
可选的 MCP 配置: 可以配置为 MCP 服务器，通过标准 MCP 协议与 LLM 客户端 (例如 Cherry Studio) 集成，提供上下文服务。

安装步骤

安装 Docker 和 Docker Compose: 确保你的系统已安装 Docker 和 Docker Compose。

下载 'docker-compose.yml' 文件:

Mac/Linux:

curl -L -O https://raw.githubusercontent.com/glidea/zenfeed/main/docker-compose.yml

Windows (PowerShell):

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/glidea/zenfeed/main/docker-compose.yml" -OutFile ([System.IO.Path]::GetFileName("https://raw.githubusercontent.com/glidea/zenfeed/main/docker-compose.yml"))

配置 API Key: 编辑 'docker-compose.yml' 文件，在 'configs.zenfeed_config.content' 部分，将 'API_KEY=your_apikey' 替换为你自己的 LLM 提供商 API Key。如果你使用默认的硅基流动模型，可以使用邀请链接注册并获取 API Key。

启动 Zenfeed:

Mac/Linux:

API_KEY=your_apikey docker-compose up -d

Windows (PowerShell):

$env:API_KEY = "your_apikey"; docker-compose up -d

访问 Web 界面: 访问 'https://zenfeed-web.pages.dev' 使用 Web 界面管理和配置 Zenfeed。如果你部署在 VPS 等环境，请访问 'https://vps_public_ip:1400' (记得开放安全组端口)。

服务器配置 (MCP 客户端配置)

Zenfeed 可以作为 MCP 服务器使用，以下是 MCP 客户端 (如 Cherry Studio) 连接 Zenfeed MCP 服务器的配置信息，用于连接到 Zenfeed 的 SSE 服务：

{
  "servers": [
    {
      "name": "zenfeed",  // MCP 服务器名称，可自定义
      "command": "docker-compose", // MCP 服务器启动命令
      "args": [  // MCP 服务器启动参数
        "up",
        "-d"
      ],
      "transports": [
        {
          "type": "sse", // 使用 SSE 传输协议
          "url": "http://localhost:1301/sse"  // Zenfeed MCP 服务器 SSE 地址，默认本地访问地址
        }
      ]
    }
  ]
}

参数注释:

'servers[0].name': MCP 服务器的名称，可以根据你的喜好自定义。
'servers[0].command': 启动 Zenfeed MCP 服务器的命令，这里使用 'docker-compose'，假设你使用 Docker Compose 部署 Zenfeed。
'servers[0].args': 启动命令的参数，'["up", "-d"]' 表示使用 Docker Compose 启动并后台运行 Zenfeed。
'servers[0].transports[0].type': 指定传输协议为 SSE (Server-Sent Events)。
'servers[0].transports[0].url': Zenfeed MCP 服务器的 SSE 地址，默认情况下为 'http://localhost:1301/sse'，如果 Zenfeed 部署在远程服务器，请替换为相应的地址。

注意: 请确保 MCP 客户端能够访问到 Zenfeed MCP 服务器的网络地址。

基本使用方法

添加 RSS 订阅源: 通过 Web 界面访问 Zenfeed，在 "订阅源" 页面添加你感兴趣的 RSS 订阅源。
配置每日简报和监控: 在 Web 界面的 "通知" 页面，配置每日简报的发送时间和内容，以及设置关键词监控等。
连接 MCP 客户端: 在支持 MCP 协议的 LLM 客户端 (如 Cherry Studio) 中，按照上述 "服务器配置" 填写 Zenfeed MCP 服务器的连接信息。
使用 MCP 功能: 连接成功后，LLM 客户端即可通过 MCP 协议与 Zenfeed 服务器交互，利用 Zenfeed 提供的资源和功能，例如查询 feed 数据、调用 AI 工具等。

关键词