Miniflux RSSリーダーとやり取りするためのモデルコンテキストプロトコル(MCP)サーバー。 このサーバーは、Minifluxクライアントを使用してMCPプロトコルを介してフィード、エントリ、ユーザー、およびカテゴリを管理するためのツールを提供します。

##特徴

• フィード管理: RSS/Atomフィードの一覧、作成、更新 -Entry Operations:エントリ、更新ステータス(既読/未読/削除)
• カテゴリ管理: フィードカテゴリのリストと整理
• 柔軟な認証: APIキーとユーザー名/パスワード認証の両方のサポート

セットアップ

##Miniflux APIキーの取得

1. Minifluxインスタンスにログイン
2. 設定 → API キーに移動
3. 新しい API キーを作成する
4. 生成されたキーを構成にコピーする

Miniflux 環境変数

| 変数 | 説明 | 必須 | お問い合わせ | [MINIFLUX_URL | あなたのミニフラックスインスタンスのURL | はい | | [MINIFLUX_API_KEY | 認証用APIキー | ◯ | | [MINIFLUX_USERNAME | 基本authのユーザー名 | ◯ | | [MINIFLUX_PASSWORD | 基本authのパスワード | はい* |

※[MINIFLUX_API_KEY または [MINIFLUX_USERNAME] と [MINIFLUX_PASSWORD をそれぞれ使用しています。

##ローカルstdioサーバー

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)