项目简介

termfeed是一个功能丰富的、键盘驱动的终端RSS阅读器，旨在提供一个快速、高效的本地化新闻阅读体验。它支持RSS订阅、文章阅读、收藏、标记、以及通过MCP协议与AI代理集成，实现智能化的内容访问和处理。

主要功能点

• 终端用户界面 (TUI):
  • 双面板布局，提供Vim风格的快捷键（如'j'/'k'移动文章，'s'/'a'切换订阅源，'v'用浏览器打开）用于快速浏览和管理RSS文章。
  • 自动标记已读、文章收藏、文章置顶（稍后阅读）等功能。
  • 支持对订阅源进行0-5星评级，并按评级分组显示。
  • 快捷键提示覆盖层，帮助用户快速上手。
• 命令行管理 (CLI):
  • 通过命令行添加、删除、更新RSS订阅源。
  • 支持OPML和文本文件格式的导入/导出功能。
  • 提供教程模式，帮助新用户快速体验。
• MCP服务器功能:
  • 作为Model Context Protocol (MCP) 服务器，允许Claude Code等AI代理访问termfeed存储的文章数据。
  • 提供标准化的资源（如未读文章、收藏文章）和工具（如更新所有订阅源、获取特定文章详情）接口。
  • 通过JSON-RPC协议进行通信，实现AI与RSS内容的实时互动和分析。

安装步骤

• 使用 'npx' 快速运行 (推荐，无需安装):
  • 尝试教程模式 (包含示例订阅源): 'npx termfeed tutorial'
  • 直接启动TUI界面: 'npx termfeed tui'
  • 运行特定命令 (例如添加订阅源): 'npx termfeed add https://example.com/feed.rss'
• 全局安装 (推荐用于长期使用):
  • 首先安装Node.js (如果尚未安装)。
  • 在终端中运行: 'npm install -g termfeed'
  • 启动TUI界面: 'termfeed tui'

服务器配置 (供MCP客户端使用)

要将termfeed作为MCP服务器集成到AI代理（如Claude Code）中，您需要提供以下配置信息：

• 服务器名称 (Server Name): 'termfeed'
• 启动命令 (Command): 'termfeed'
• 启动参数 (Arguments): 'mcp-server'
• 功能描述 (Description): 本地RSS阅读器，通过MCP协议向AI代理提供最新的文章数据和更新功能。
• 可用资源 (Resources):
  • 未读文章 (URI: 'articles://unread'): 获取您RSS订阅中最新的未读文章列表（默认最多10条）。AI可用于快速了解和总结最新资讯。
  • 收藏文章 (URI: 'articles://favorites'): 获取您已收藏的文章列表（默认最多10条）。AI可用于回顾和分析您认为重要的内容。
• 可用工具 (Tools):
  • 'update_all_feeds' (更新所有订阅源): 执行此工具以更新所有已订阅的RSS源，获取最新的文章。
  • 'get_article' (获取文章详情): 根据指定的文章ID获取单篇文章的完整详细内容。需要一个名为 'id' 的整数参数来指定文章ID。

基本使用方法 (作为MCP服务器)

1. 启动MCP服务器: 在终端中运行命令 'termfeed mcp-server'。服务器将启动并等待MCP客户端连接。
2. 在AI代理中使用 (例如Claude Code): 将上述服务器配置添加到您的AI代理环境中。具体步骤取决于您使用的AI代理，通常涉及在AI客户端的设置界面中添加一个新的MCP服务器。
   • 一旦配置完成，AI代理就可以通过自然语言请求访问termfeed的资源和工具。
   • 例如，您可以向AI提问：“请总结一下termfeed的未读文章。”
   • 或者：“查找文章ID为456的完整内容并告诉我。”
   • AI将通过MCP协议与termfeed服务器通信，获取所需信息并进行处理。