ttrss-mcp

基于 MCP (Model Context Protocol) 的 tt-rss 客户端，允许通过 AI 助手读写 Tiny Tiny RSS 订阅源，并支持日报功能。

官方接口文档：https://github.com/tt-rss/tt-rss/wiki/Api-Reference

使用方法

本服务通过 stdio 传输协议运行，AI 客户端直接启动进程通信。

{
  "mcpServers": {
    "tt-rss": {
      "command": "npx",
      "args": ["ttrss-mcp"],
      "env": {
        "TT_RSS_URL": "https://rss.example.com/tt-rss",
        "TT_RSS_SID": "your-session-id"
      }
    }
  }
}

MCP 工具列表

订阅源管理

| 工具 | 说明 | |------|------| | get_categories | 获取分类列表 | | get_feeds | 获取订阅源列表 | | subscribe_feed | 订阅新 RSS 源 | | unsubscribe_feed | 取消订阅 |

文章管理

| 工具 | 说明 | |------|------| | get_headlines | 获取文章标题列表 (支持过滤/分页) | | get_article | 获取文章全文 | | get_unread_count | 获取未读数量 | | update_article | 更新文章状态 (星标/已读/发布/笔记) | | catchup_feed | 标记源为已读 | | share_to_published | 分享到已发布 | | search_articles | 搜索文章 |

标签管理

| 工具 | 说明 | |------|------| | get_labels | 获取标签列表 | | set_article_label | 设置/移除文章标签 |

系统与日报

| 工具 | 说明 | |------|------| | get_config | 获取服务器配置 | | generate_daily_report | 生成日报 (按源分组的文章汇总) |

项目结构

ttrss-mcp/
├── src/
│   ├── index.ts            # MCP Server 入口 (stdio)
│   ├── ttrss-client.ts     # tt-rss API 客户端封装
│   ├── types.ts            # TypeScript 类型定义
│   └── tools/
│       ├── feeds.ts        # 订阅源管理工具
│       ├── articles.ts     # 文章读写工具
│       ├── labels.ts       # 标签管理工具
│       └── report.ts       # 日报生成工具
├── .env.example
├── package.json
└── tsconfig.json

License

MIT