FreshRSS MCP Server

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

许可证

麻省理工学院