MMCPMarkets
SI

seiji/inoreader-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

10 stars 4 forks Качество 67 Тренд 38
Repository Install

An MCP (Model Context Protocol) server that provides RSS feed management capabilities through the Inoreader API. This enables LLMs like Claude to read and manage RSS feeds on your behalf.

Обзор

An MCP (Model Context Protocol) server that provides RSS feed management capabilities through the Inoreader API. This enables LLMs like Claude to read and manage RSS feeds on your behalf. Built with Bun for fast startup and low memory usage. - - Browser-based login with secure keychain storage - - Tokens are refreshed automatically when expired - - Get unread, starred, or all articles from your feeds - - Add or remove RSS feed subscriptions - - Mark articles as read/unread, star articles, add tags - - List subscriptions, folders, tags, and unread counts - Bun 1.0+ - Inoreader Pro account (API access requires Pro subscription) - Inoreader API credentials (App ID and App Key) - : Keychain (built-in) - : libsecret (apt install libsecret-tools) No installation required - run directly from GitHub: 1. Go to Inoreader Developer Portal 2. Register a new application with these settings: - : http://localhost:19812/callback - : read and write 3.

README

Показан фрагмент оригинального README. Открыть оригинал.

Inoreader MCP Server

An MCP (Model Context Protocol) server that provides RSS feed management capabilities through the Inoreader API. This enables LLMs like Claude to read and manage RSS feeds on your behalf.

Built with Bun for fast startup and low memory usage.

Features

  • OAuth2 authentication - Browser-based login with secure keychain storage
  • Automatic token refresh - Tokens are refreshed automatically when expired
  • Read articles - Get unread, starred, or all articles from your feeds
  • Manage subscriptions - Add or remove RSS feed subscriptions
  • Organize content - Mark articles as read/unread, star articles, add tags
  • Browse feeds - List subscriptions, folders, tags, and unread counts

Requirements

  • Bun 1.0+
  • Inoreader Pro account (API access requires Pro subscription)
  • Inoreader API credentials (App ID and App Key)
  • macOS: Keychain (built-in)
  • Linux: libsecret (apt install libsecret-tools)

Installation

Quick Start (via bunx)

No installation required - run directly from GitHub:

bunx github:seiji/inoreader-mcp-server          # latest
bunx github:seiji/inoreader-mcp-server#v0.4.0   # specific version

Local Development

git clone https://github.com/seiji/inoreader-mcp-server.git
cd inoreader-mcp-server
bun install

Authentication

1. Get API Credentials

  1. Go to Inoreader Developer Portal
  2. Register a new application with these settings:
    • Redirect URI: http://localhost:19812/callback
    • Scopes: read and write
  3. Note your App ID and App Key

2. Set Environment Variables

export INOREADER_APP_ID="your-app-id"
export INOREADER_APP_KEY="your-app-key"

3. Login

# This opens your browser for OAuth authentication
bunx github:seiji/inoreader-mcp-server auth login

Alternatively, authenticate from your MCP client: call the auth_login tool, open the returned URL in a browser, then call auth_complete.

Tokens are securely stored in your system keychain:

  • macOS: Keychain Access
  • Linux: GNOME Keyring / KDE Wallet (via libsecret)

To bypass the keychain, set INOREADER_ACCESS_TOKEN. It takes priority over tokens stored in the keychain.

Auth Commands

# Login - opens browser for OAuth authentication
bunx github:seiji/inoreader-mcp-server auth login

# Check authentication status
bunx github:seiji/inoreader-mcp-server auth status

# Logout - remove tokens from keychain
bunx github:seiji/inoreader-mcp-server auth logout

Usage

Running the Server

# Via bunx (recommended)
bunx github:seiji/inoreader-mcp-server

# Local development
bun run start

MCP Client Configuration

Install the server with your MCP client. INOREADER_APP_ID and INOREADER_APP_KEY are required for login and token refresh.

Standard config works in most of the tools:

{
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "inoreader": { "command": "bunx", "args": ["github:seiji/inoreader-mcp-server"], "env": { "INOREADER_APP_ID": "your-app-id", "INOREADER_APP_KEY": "your-app-key" } } } }