news-mcp

📰 News MCP Server

FastMCP-based MCP server that turns RSS into deduplicated, enriched news clusters.

Quick start

cd news-mcp
source .venv/bin/activate
pip install -r requirements.txt
./run.sh

Default SSE mount (FastMCP):

• http://127.0.0.1:8506/mcp/sse

Health:

• http://127.0.0.1:8506/health

What this server provides

• Fetches RSS from https://breakingthenews.net/news-feed.xml
• Deduplicates articles into clusters (v1 fuzzy title similarity)
• Enriches clusters with Groq (topic/entities/sentiment/keywords)
• Caches clusters + Groq fields in SQLite

Tools (MCP)

1) get_latest_events(topic, limit)

• topic is a coarse category: crypto | macro | regulation | ai | other

2) get_events_for_entity(entity, limit)

• substring, case-insensitive match over extracted entities

3) get_event_summary(event_id)

• Groq-written compressed narrative for a given cluster_id

4) detect_emerging_topics(limit)

• derives “emerging” signals from recent cached clusters

Configuration

See news-mcp/.env. Key variables:

• GROQ_API_KEY, GROQ_MODEL, GROQ_DEBUG
• NEWS_REFRESH_INTERVAL_SECONDS (default 900)
• NEWS_BACKGROUND_REFRESH_ON_START (default true)
• NEWS_CLUSTERS_TTL_HOURS