News

Provides RSS-based news data and actions to fetch, search, list feeds, and view article details through an MCP client.

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "ltejedor-newsfeed-mcp": {
      "command": "python",
      "args": [
        "/ABSOLUTE/PATH/TO/news_mcp.py"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "NEWS_MCP_CUSTOM_FEEDS": "name1:url1;name2:url2"
      }
    }
  }
}

You run a News MCP Server that fetches the latest information from RSS feeds, caches results for faster responses, and exposes a flexible set of tools you can call through an MCP client to get, search, and inspect news articles.

How to use

You interact with the News MCP Server through an MCP client to get current news, search for articles, view feed contents, and inspect article details. Use the available tools to retrieve data in a structured way without worrying about underlying RSS sources. You can: fetch the latest articles by category, search for terms across feeds, load content from a specific feed, and obtain full article details by URL. Use these capabilities to power AI assistants, dashboards, or custom workflows.

How to install

Prerequisites you need on your machine are Python 3.10 or higher and the MCP SDK 1.2.0 or higher.

# Step 1: Clone the project
git clone https://github.com/ltejedor/newsfeed-mcp.git
cd news-mcp

# Step 2: Set up a virtual environment and install dependencies
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# Step 3: Run the server locally
python news_mcp.py

Additional configuration and running with Docker

You can also run the server using Docker to simplify dependency management and deployment.

docker-compose up -d

Available tools

health_check

Check if the server is running correctly and return basic stats such as uptime, active feeds, and request counts.

list_available_feeds

Provide a list of all available feeds and their categories so you know what you can query.

get_latest_news

Return recent news articles, optionally filtered by a category such as tech, general, business, science, travel, or politics, with an optional limit.

search_news

Find articles that match a specific search term across all feeds, with an optional limit on results.

get_feed_content

Retrieve articles from a specific feed by its name, with an optional limit.

get_article_details

Fetch detailed information about a single article using its URL.