seiji/inoreader-mcp-server

本页由 AI 翻译，技术细节请以原文为准。查看原文

10 stars 4 forks 质量 67 趋势 38

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

Go to Inoreader Developer Portal
Register a new application with these settings:
- Redirect URI: http://localhost:19812/callback
- Scopes: read and write
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"

# 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:

在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 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"
      }
    }
  }
}