Miniflux MCP

Miniflux MCP 服务器

全面的 模型上下文协议 使AI助手能够进行交互的服务器 Miniflux（可译为“迷你流”或根据具体语境保留原名，因其是一个特定的RSS阅读器或类似工具的名称） 通过自然语言使用RSS订阅阅读器。

特点/功能

• 订阅源发现与订阅发现并订阅任何网站的RSS/Atom订阅源
• 入口管理阅读、筛选和管理订阅条目（标记为已读/未读，加星标/书签）
• 组织创建类别并整理订阅源
• 搜索与筛选使用高级过滤器（状态、日期范围、信息源、类别）进行全文搜索
• 饲料健康监控订阅源解析错误并手动刷新订阅源
• OPML 支持导入和导出订阅以进行迁移和备份
• 收藏夹（或“精选收藏”）维护已收藏文章的精选列表

快速入门

先决条件

• Python 3.10 或更高版本
• 一个可通过HTTPS访问的正在运行的Miniflux实例（v2.0.21+）
• 一个与MCP兼容的AI助手（Claude Desktop、Claude Code、Cursor、ChatGPT）

安装

pip install miniflux-mcp

配置

对于Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macos) 或同等系统：

{
  "mcpServers": {
    "miniflux": {
      "command": "python",
      "args": ["-m", "miniflux_mcp"],
      "env": {
        "MINIFLUX_URL": "https://miniflux.example.com",
        "MINIFLUX_API_KEY": "your-api-key-here"
      }
    }
  }
}

为克劳德·科德（Claude Code）

fastmcp install claude-code --name miniflux

然后在生成的配置文件中设置环境变量。

使用示例

配置完成后，通过您的AI助手与您的Miniflux实例进行交互：

• 订阅“请将我订阅到 https://example.com/blog”
• 阅读“给我显示最近10篇未读的文章”
• 搜索“查找上周发表的关于人工智能的文章”
• 组织“创建一个名为‘技术’的类别，并将订阅源#42移入其中”
• 书签“明星条目#12345”
• 出口“将我的订阅源导出为OPML格式”

文档

• 快速入门指南 - 详细的设置说明
• API 参考 - 完整的MCP工具参考手册（即将推出）
• 开发指南 - 贡献与开发环境设置

项目状态

🚧（施工中/道路封闭/禁止通行等标志，具体含义根据上下文确定） 阿尔法 - 正在积极开发中。核心功能（订阅动态、条目阅读）已完善。其他功能正在进行中。

要求

• Miniflux API v1（Miniflux v2.0.21或更高版本）
• 与Miniflux实例的HTTPS连接
• 有效的API密钥或用户名/密码凭证

许可证

MIT 许可证 - 详见 LICENSE 文件

支持

• 问题：
• Miniflux 文档https://miniflux.app/docs/（中文可表述为：“Miniflux 应用文档页面”）

建筑学

构建于：

• FastMCP 2.0 - MCP服务器框架
• httpx - 异步HTTP客户端
• Pydantic - 数据验证和序列化