miniflux-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
miniflux-mcp-server
MinifluxをChatGPT等から使うためのStreamable HTTP MCPサーバー。記事検索・本文取得、既読状態・ブックマーク、フィード・カテゴリの管理に対応します。
起動
Node.js 24以上とpnpmを使用します。
pnpm install --frozen-lockfile
MINIFLUX_URL=https://miniflux.example.com pnpm dev接続先は http://localhost:3000/mcp。開発時の暗号鍵は使い捨てです。
MinifluxはAPIアクセス用のOAuth認可サーバーを提供しないため、本サーバーがOAuth(PKCE S256、ChatGPT・Claude・Museに限定した動的クライアント登録、refresh)を提供します。認可画面で Minifluxの設定 → APIキー から作成した専用キーを入力します。キーは /v1/me で検証し、暗号化したトークンに格納します。APIキーをGitやサーバー環境変数に保存する必要はありません。
スコープは miniflux:read、miniflux:write、offline_access。省略時は読み取りのみです。書き込み権限を追加する場合は再接続して認可してください。Miniflux側のAPIキーを削除すると、以後の上流API呼び出しは拒否されます。
Related MCP server: ai-service-integration-starter
本番設定
環境変数 | 内容 |
| MinifluxのHTTP(S) origin( |
| MCP公開origin。productionではHTTPS必須 |
| HTTPポート、既定3000 |
| リプレイ防止SQLite、既定 |
| 認可リクエストの暗号鍵 |
| 認可コードの暗号鍵 |
| アクセストークンの暗号鍵 |
| refreshと動的登録の暗号鍵 |
| 任意の事前登録クライアント。既定 |
| 上流HTTPタイムアウト、既定15000ms |
| 上流レスポンスの上限、既定4MiB |
鍵はそれぞれ異なる32byteを生成し、k1:<base64url> 形式で設定します。
node -e "console.log('k1:'+require('crypto').randomBytes(32).toString('base64url'))"ローテーション時は k2:<new>,k1:<old> の順で指定します。先頭の鍵で発行し、残りで過去のトークンを検証します。refresh用の旧鍵を削除するとその鍵で登録されたクライアントも無効になるため、クライアント再登録が必要です。
docker run --rm -p 3000:3000 --env-file .env \
--mount type=volume,source=miniflux-mcp-data,target=/data \
ghcr.io/rokoucha/miniflux-mcp-server:latestNODE_ENV=production、ISSUER、MINIFLUX_URL、4種の鍵を .env に設定してください。コンテナは非rootで動作します。/data はUID/GID 1000が書き込める必要があります。
認可コードとrefreshは一度だけ使用でき、その消費記録をSQLiteに保存します。SQLiteは単一replica、ローカル/block storageで運用し、NFS上で共有しないでください。DBを削除・古いバックアップに戻すと未期限切れgrantの再使用防止を失います。その場合は暗号鍵も更新してください。
ツール
読み取り:
list_entries,get_entry,get_counters,list_feeds,get_feed,list_categories書き込み:
update_entries,create_feed,update_feed,delete_feed,refresh_feed,create_category,update_category,delete_category
list_entries は本文を省き、既定20件・最大100件のページングを返します。全文は get_entry で取得します。取得だけで既読にはしません。記事やタイトルは信用できない外部データです。フィード設定に含まれるパスワード・cookie・非公開feed URLは返しません。update_entries は状態とスターを指定値に設定します。Miniflux 2.3.2以降が必要です。
CIとmateria
GitHub Actionsでlint・型検査・テスト・ビルドを実行し、linux/amd64・linux/arm64のイメージを検証します。default branchへのpushまたは手動実行だけがGHCRへ latest・JST時刻タグ・SHAタグを公開します。
materiaのGitOps構成は デプロイ手順 を参照してください。設計は docs/design.md。
pnpm run lint
pnpm run type-check
pnpm test
pnpm run build参照
cosense-cli-mcp のOAuth/CIをベースに実装(MIT)
MIT License © 2026 Rokoucha
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Managed cloud RSS and Atom feed reader with a remote Model Context Protocol (MCP) endpoint. Zero server setup required — enables AI agents like Claude to instantly subscribe to feeds, search full-text articles, extract readable content, and access curated AI editions ("Your Newspaper") over secure streamable HTTP.
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
Your feeds inside your AI. Read and search the articles of the RSS feeds, YouTube channels, podcasts and Google News searches you follow. On Plus and Pro, also save, tag, highlight and add notes. OAuth sign-in, every FeedNest plan.
RSS & Atom feed manager with full-text search, AI curation, and remote MCP endpoint.
Related MCP Servers
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with a user's personal feed subscriptions, articles, highlights, notes, and tags through natural language, supporting tasks like search, summaries, tagging, and read-status management.1MIT- AlicenseNot gradedqualityCmaintenanceEnables exposing product capabilities to ChatGPT, Claude, and other MCP clients via a stateless Streamable HTTP endpoint with OAuth resource binding and structured-output helpers.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to securely interact with the BlogWarp REST API via Streamable HTTP, providing read-only access to posts, notifications, timeline, conversations, and following, plus mutating operations such as drafting, publishing, replying, following, and marking notifications read with explicit confirmation.MIT
- AlicenseAqualityBmaintenanceEnables MCP clients like Claude to subscribe to RSS/Atom feeds, list feeds with unread counts, fetch and search new items, and mark items as read, all scoped to the authenticated user's account.8341MIT