# RSS Feed MCP Server

An MCP server that allows Claude to fetch and process RSS feed data through the Model Context Protocol.

## Overview

This server provides direct access to RSS/Atom feeds from Claude via the Model Context Protocol (MCP). It supports feed registration, management, and retrieval functionality.

## Installation

```bash
npx rss-feed-mcp-server
```

## Usage

### Claude Desktop Configuration

Add the following to your `~/.config/claude/config.json`:

```json
{
  "mcpServers": {
    "rss-feed": {
      "command": "npx",
      "args": ["rss-feed-mcp-server"]
    }
  }
}
```

### CLI Options

```bash
# Basic execution
npx rss-feed-mcp-server

# Debug mode
npx rss-feed-mcp-server --debug

# Specify config file
npx rss-feed-mcp-server --config /path/to/config.json

# Show help
npx rss-feed-mcp-server --help
```

## Available Tools

### 1. fetch_rss_feed
Fetch and parse RSS/Atom feeds.

**Parameters:**
- `url` (string, required): RSS/Atom feed URL
- `limit` (number, optional): Maximum number of articles to fetch (default: 10)
- `includeContent` (boolean, optional): Include full article content (default: false)

### 2. list_feeds
List all registered RSS feeds.

### 3. add_feed
Register a new RSS feed.

**Parameters:**
- `name` (string, required): Display name for the feed
- `url` (string, required): RSS/Atom feed URL

### 4. remove_feed
Remove a registered RSS feed.

**Parameters:**
- `feedId` (string, required): ID of the feed to remove

## Configuration

Configuration file is stored at `~/.config/rss-feed-mcp/config.json`.

```json
{
  "feeds": [],
  "defaultLimit": 10,
  "timeout": 10000,
  "userAgent": "RSS-Feed-MCP-Server/1.0.0"
}
```

## License

MIT