Content
# Finance News RSS MCP Server
A Model Context Protocol (MCP) server that provides real-time finance news from major RSS feeds. Built with [FastMCP](https://github.com/jlowin/fastmcp) to demonstrate MCP basics.
## What This MCP Does
This MCP server gives Claude access to finance news from major sources including:
- Bloomberg
- Wall Street Journal (WSJ)
- CNBC
- Seeking Alpha
- MarketWatch
- Financial Times
The server provides two tools:
1. **get_latest_finance_news** - Fetch the latest news from all sources or a specific source
2. **search_finance_news** - Search across all feeds for articles matching a keyword
## Installation
Install dependencies using uv:
```bash
uv sync
```
## How to Run
Start the MCP server:
```bash
uv run python main.py
```
Or configure it in your Claude Desktop app by adding to your MCP settings:
```json
{
"mcpServers": {
"finance-news": {
"command": "uv",
"args": ["--directory", "/path/to/example", "run", "python", "main.py"]
}
}
}
```
**Important Notes:**
- Replace `/path/to/example` with the actual path to your project directory
- If you get a "spawn uv ENOENT" error, use the full path to `uv`:
- Find it with: `which uv`
- Common locations: `~/.local/bin/uv` or `~/.cargo/bin/uv`
- Update `command` to the full path, e.g., `"/Users/yourname/.local/bin/uv"`
## Example Questions to Ask Claude
Once connected, you can ask Claude questions like:
- "What are the latest finance news headlines?"
- "Get me the top 5 news articles from Bloomberg"
- "Search for news about 'inflation' in finance feeds"
- "What's the latest news from CNBC?"
- "Find articles about 'Federal Reserve' or 'interest rates'"
- "Show me recent Yahoo Finance headlines"
## Available Tools
### get_latest_finance_news
Fetch the latest finance news articles.
**Parameters:**
- `limit` (int, default=10): Maximum number of articles to return
- `source` (str, default="all"): News source to fetch from
- Options: "all", "bloomberg", "wsj", "cnbc", "seekingalpha", "marketwatch", "ft"
**Example:**
```python
get_latest_finance_news(limit=5, source="wsj")
```
### search_finance_news
Search for articles matching a keyword across all feeds.
**Parameters:**
- `query` (str, required): Search keyword to find in titles or descriptions
- `limit` (int, default=10): Maximum number of matching articles to return
**Example:**
```python
search_finance_news(query="bitcoin", limit=5)
```
## Implementation Details
- **No caching**: Fetches RSS feeds on-demand for real-time updates
- **Error handling**: Gracefully skips feeds that fail to load
- **Simple & clean**: Single-file implementation, perfect portfolio piece
- **Dependencies**: fastmcp, feedparser, httpx
## Project Structure
```
example/
├── main.py # MCP server implementation
├── pyproject.toml # Project dependencies
├── uv.lock # Dependency lock file
└── README.md # This file
```
## How It Works
The server uses:
- **FastMCP** to create the MCP server and register tools
- **httpx** to fetch RSS feed URLs
- **feedparser** to parse RSS/Atom feeds into structured data
Each tool fetches feeds in real-time, parses them, and returns structured article data including title, link, published date, description, and source name.
## License
MIT
