一台用于与Miniflux RSS阅读器交互的模型上下文协议（MCP）服务器。该服务器通过使用Miniflux 客户端通过MCP协议管理信息流、条目、用户和类别。

特色

• 订阅管理：列出、创建和刷新RSS/Atom订阅源
• 条目操作：读取条目，更新状态（读取/未读/删除）
• 分类管理：列出和组织信息流分类
• 灵活认证：支持API密钥和用户名/密码认证

布置

获取Miniflux API密钥

1. 登录你的Miniflux实例
2. 进入设置→ API 密钥
3. 创建一个新的 API 密钥
4. 将生成的密钥复制到你的配置中

微通环境变量

*要么使用MINIFLUX_API_KEY，要么同时使用MINIFLUX_USERNAME和[MINIFLUX_PASSWORD

本地标准服务器

Miniflux MCP Server

A Model Context Protocol (MCP) server for interacting with Miniflux RSS reader. This server provides tools to manage feeds, entries, users, and categories through the MCP protocol using Miniflux Client.

Features

• Feed Management: List, create, and refresh RSS/Atom feeds
• Entry Operations: Read entries, update status (read/unread/removed)
• Category Management: List and organize feed categories
• Flexible Authentication: Support for both API key and username/password authentication

Setup

Getting a Miniflux API Key

1. Log into your Miniflux instance
2. Go to Settings → API Keys
3. Create a new API key
4. Copy the generated key to your configuration

Miniflux Environment Variables

*Either use MINIFLUX_API_KEY OR both MINIFLUX_USERNAME and MINIFLUX_PASSWORD

Local stdio Server

stdio is the default transport and is intended for an MCP client that starts the server locally.

Using Docker

docker build -t miniflux-mcp .
docker run -i --rm --env-file .env miniflux-mcp

Or use the published image:

docker run -i --rm --env-file .env jwonder/miniflux-mcp:latest

Claude Code (.mcp.json)

Add the following .mcp.json file to your project root:

{
  "mcpServers": {
    "miniflux": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MINIFLUX_URL",
        "-e",
        "MINIFLUX_API_KEY",
        "jwonder/miniflux-mcp:latest"
      ],
      "env": {
        "MINIFLUX_URL": "${MINIFLUX_URL}",
        "MINIFLUX_API_KEY": "${MINIFLUX_API_KEY}"
      }
    }
  }
}

Remote Streamable HTTP Server

The remote server exposes a Streamable HTTP MCP endpoint protected by a static Bearer token.

Set a strong token and start the container with the Streamable HTTP transport:

export MCP_AUTH_TOKEN='replace-with-a-strong-secret'

docker run --rm \
  -p 8080:8080 \
  --env-file .env \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_AUTH_TOKEN \
  jwonder/miniflux-mcp:latest

Configure an MCP client to connect to http://your-server:8080/mcp and send:

Authorization: Bearer replace-with-a-strong-secret

Claude Code (.mcp.json)