Simply Feed MCP Server

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

Related MCP server: mcp-rss

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:

Usage

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