Miniflux RSS 리더와 상호 작용하는 모델 Context Protocol (MCP) 서버. 이 서버는 Miniflux Client를 사용하여 MCP 프로토콜을 통해 피드, 항목, 사용자 및 카테고리를 관리하는 도구를 제공합니다.

특징

• Feed Management: 목록, 생성 및 RSS / 원자 피드를 새로 고침 -Entry Operations: 항목, 업데이트 상태(read/unread/removed)
• Category Management: 목록 및 구성 피드 카테고리
• Flexible 인증: API 키와 사용자 이름/암호 인증 모두 지원

설치

Miniflux API 키 얻기

1. Miniflux 인스턴스에 로그인
2. 설정 → API 키로 이동
3. 새로운 API 키 만들기
4. 생성 된 키를 구성에 복사

Miniflux 환경 변수

*Either 사용 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)