RSS订阅管理服务

FreshRSS MCP Server是一个用于与FreshRSS实例交互的模型上下文协议服务器,提供文章、订阅源、文件夹和标签的管理功能。

  • by alysson-souza
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 alysson-souza/freshrss-mcp

使用说明

FreshRSS MCP服务器

用于与FreshRSS实例交互的模型上下文协议(MCP)服务器。

特性

  • 文章:列表、筛选、已读/未读、星号/未星号、标记全部已读
  • 订阅源:列表、订阅、取消订阅、重命名、在文件夹之间移动
  • 文件夹和标签:列表、通过标记创建、重命名、删除
  • OPML:导出/导入订阅
  • 快速添加:添加网站URL,让FreshRSS发现提要
  • 狂热助手:收藏夹、未读/已标记的ID列表

需求

  • Node.js 18+
  • 启用Google阅读器API的FreshRSS
  • FreshRSS API密码(设置→ 个人资料→ API管理)

安装

npm install -g @equaldepth/freshrss-mcp-server

用法

克劳德桌面

{
  "mcpServers": {
    "freshrss": {
      "command": "npx",
      "args": ["@equaldepth/freshrss-mcp-server"],
      "env": {
        "FRESHRSS_URL": "https://your-freshrss-instance.com",
        "FRESHRSS_USERNAME": "your-username",
        "FRESHRSS_API_PASSWORD": "your-api-password"
      }
    }
  }
}

GitHub Copilot

{
  "servers": {
    "freshrss": {
      "command": "npx",
      "args": ["@equaldepth/freshrss-mcp-server"],
      "env": {
        "FRESHRSS_URL": "https://your-freshrss-instance.com",
        "FRESHRSS_USERNAME": "your-username",
        "FRESHRSS_API_PASSWORD": "your-api-password"
      }
    },
  }
}

工具

文章:

  • list_articles
  • mark_as_read
  • mark_as_unread
  • star_articles
  • unstar_articles
  • mark_all_as_read

喂养:

  • list_feeds
  • subscribe
  • unsubscribe
  • edit_feed
  • export_opml
  • import_opml
  • quickadd_feed

文件夹和标签:

  • list_folders
  • list_labels
  • add_labels
  • remove_labels
  • rename_folder
  • rename_label
  • delete_folder
  • delete_label

统计数据:

  • get_stats
  • get_user_info

传真同步(Fever API)(&S):

  • list_favicons
  • get_feed_favicon
  • list_unread_article_ids
  • list_starred_article_ids

例子

{ "name": "list_articles", "arguments": { "filter": "unread", "order": "newest", "count": 10 } }
{ "name": "list_articles", "arguments": { "state": "starred", "count": 5 } }
{ "name": "subscribe", "arguments": { "url": "https://example.com/feed.xml", "title": "Example", "category": "Tech" } }
{ "name": "edit_feed", "arguments": { "feedId": "1", "category": "Tech" } }
{ "name": "export_opml", "arguments": {} }

工具输入经过严格验证;未知字段错误。

发展

npm run dev
npm run lint
npm run typecheck
npm run format
npm run build

许可证

麻省理工学院