Simply Feed

A Model Context Protocol (MCP) server for managing and querying RSS/news feeds. This server enables AI assistants to fetch, search, and retrieve information from RSS feeds in real-time.

MCP Tools

This server provides the following MCP tools:

get-recent-feed-items

Retrieve the most recent items from all configured news/RSS feeds within a specified time window.

• recencyInMinutes (optional): Look back period in minutes (default: 120)
• limit (optional): Number of items to return (max: 50, default: 25)
• skip (optional): Number of items to skip for pagination

get-feed-items

Retrieve items from a specified news/RSS feed, ordered by recency (newest first), with pagination support.

• feedId (required): The news/RSS feed ID from which to get items
• limit (optional): Number of items to return (max: 50, default: 25)
• skip (optional): Number of items to skip for pagination

search-feed-items

Search and retrieve items using natural language queries.

• query (required): Description of the items to search for
• feedId (optional): Filter results to a specific feed
• limit (optional): Number of items to return (max: 50, default: 25)
• skip (optional): Number of items to skip for pagination

get-item-details

Get full details for a specific feed item.

• feedId (required): The feed ID containing the item
• id (required): The specific item ID

list-feeds

Retrieve a list of all configured RSS/news feeds with pagination support.

• limit (optional): Number of feeds to return (max: 50, default: 10)
• skip (optional): Number of feeds to skip for pagination

Installation

Prerequisites

• Node.js 20+
• npm or yarn

From npm

Using npx (Recommended)

No installation required! Simply use npx to run the latest version:

Global Installation (Optional)

If you prefer to install globally:

npm install -g simply-feed-mcp

From Source

1. Clone the repository:

git clone https://github.com/hmmroger/simply-feed-mcp.git
cd simply-feed-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Configuration

Feed Configuration

The feed configuration is used by the worker to fetch and update feeds. Create a feeds.json file (or any custom filename) and specify its location using --config_file with your RSS feeds:

[
  {
    "feedUrl": "https://www.technologyreview.com/feed/"
  }
]

Environment Variables

Configure the server using these environment variables:

Variable	Description	Default	MCP/Worker
SIMPLY_FEED_CONFIG_FILE_NAME	Custom feeds config file name	feeds.json	Worker
SIMPLY_FEED_CONFIG_BLOB_NAME	Load config from Azure Blob (format: container/blob)	-	Worker
SIMPLY_FEED_STORAGE_CONNECTION_STRING	Azure Storage connection string	-	Both
SIMPLY_FEED_STORAGE_FILE_FOLDER	Local storage folder for feed data	-	Both
SIMPLY_FEED_LLM_API_KEY	API key for LLM integration	-	Both
SIMPLY_FEED_LLM_BASE_URL	Base URL for LLM API	https://generativelanguage.googleapis.com/v1beta/openai	Both
SIMPLY_FEED_LLM_MODEL	LLM model to use	gemini-2.5-flash-lite	Both
SIMPLY_FEED_ITEMS_RETENTION_DAYS	Days to retain feed items	-	Worker

Usage

[!NOTE] You must have one instance of simply-feed-mcp running as a worker to fetch and update feeds, otherwise the MCP server will not see any feeds.

Required Environment Variables

SIMPLY_FEED_LLM_API_KEY is required.

Background Worker

Run the background worker to continuously fetch and update feeds:

# Run continuously (default: refresh every 15 minutes)
npx simply-feed-mcp --worker

# Run once and exit
npx simply-feed-mcp --worker --run_once

# Custom refresh interval (in seconds)
npx simply-feed-mcp --worker --refresh_interval 600

# Use custom config file and path
npx simply-feed-mcp --worker --config_file /custom/path/my-feeds.json

# Use Azure Blob config
npx simply-feed-mcp --worker --config_blob_name container/feeds.json

MCP Server

Ensure you specify the same values for environment variables that were used in the worker.

Integration

Claude Desktop

Add to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "simply-feed-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "simply-feed-mcp"
      ],
      "env": {
        "SIMPLY_FEED_LLM_API_KEY": "<API KEY>"
      }
    }
  }
}

License

MIT License - see LICENSE file for details.

Support

• GitHub Issues: Report bugs or request features
• Repository: https://github.com/hmmroger/simply-feed-mcp