Сервер Model Context Protocol (MCP) для взаимодействия с считывателем Miniflux RSS. Этот сервер предоставляет инструменты для управления каналами, входами, пользователями и категориями через протокол MCP с использованием клиента Miniflux.

Особенности

** Управление питанием**: Список, создание и обновление RSS/Atom ** Операции входа**: Записи для чтения, статус обновления (читать/не читать/удалить) ** Управление категориями**: Перечислить и организовать категории кормов ** Гибкая аутентификация**: Поддержка ключа API и аутентификации имени пользователя / пароля

Настройка

Получение ключа API Miniflux

1.Зайдите в свой экземпляр Miniflux 2. Перейти к настройкам → API-ключи 3.Создать новый API-ключ 4.Копировать сгенерированный ключ к вашей конфигурации

Переменные среды Miniflux

| Переменная | Описание | Требуемое |

| MINIFLUX_URL | Ваш экземпляр Miniflux URL | Да | | MINIFLUX_API_KEY | Ключ API для аутентификации | Да* | | MINIFLUX_USERNAME | Имя пользователя для базового аута | Да* | | MINIFLUX_PASSWORD | Пароль для базового аута | Да* |

Используйте 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)