# 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
