MCP 服务器

ttrss-mcp

An MCP server that enables AI assistants to manage Tiny Tiny RSS feeds, including reading articles, updating statuses, and searching content. It also provides tools for feed management and generating automated daily reports.

README

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