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