MCP News Server

A Model Context Protocol (MCP) server that fetches news from trusted global sources.

🗞️ Supported News Sources

Source	ID
Reuters	reuters
BBC News	bbc
Associated Press	associated-press
Al Jazeera	al-jazeera
The Hindu	the-hindu
Times of India	times-of-india
CNN	cnn
The Guardian	the-guardian
New York Times	nytimes
Washington Post	washington-post

🛠️ Available Tools

1. search_news

Search for news articles by keywords.

Keywords: "iran israel" or "climate change"
Sources: Optional filter (e.g., ["reuters", "bbc"])
Max Results: Up to 25 articles

2. get_top_headlines

Get latest headlines from trusted sources.

3. list_news_sources

List all available news sources.

📦 Installation

Step 1: Install Dependencies

cd mcp-news-server
pip install -r requirements.txt

Step 2: Get NewsAPI Key (Recommended)

1. Go to https://newsapi.org/register
2. Sign up for a free account
3. Copy your API key

Step 3: Configure API Key

# Copy example env file
copy .env.example .env

# Edit .env and add your API key
NEWS_API_KEY=your_actual_api_key

Note: The server works without an API key using RSS feeds, but NewsAPI provides better search results.

⚙️ Configuration for VS Code (Copilot)

Add this to your VS Code settings.json:

{
    "mcp": {
        "servers": {
            "news-server": {
                "command": "python",
                "args": ["c:\\Users\\om.katyarmal.NEUREALM\\Desktop\\New folder (5)\\mcp-news-server\\server.py"],
                "env": {
                    "NEWS_API_KEY": "your_api_key_here"
                }
            }
        }
    }
}

⚙️ Configuration for Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
    "mcpServers": {
        "news-server": {
            "command": "python",
            "args": ["c:\\Users\\om.katyarmal.NEUREALM\\Desktop\\New folder (5)\\mcp-news-server\\server.py"],
            "env": {
                "NEWS_API_KEY": "your_api_key_here"
            }
        }
    }
}

🚀 Usage Examples

Once configured, you can use these tools in your conversations:

Search for specific news:

"Search news about iran israel conflict"

Get headlines from specific sources:

"Get top headlines from reuters and bbc"

List available sources:

"What news sources are available?"

🔄 How It Works

1. Primary Method: Uses NewsAPI.org for comprehensive search across sources
2. Fallback Method: If NewsAPI is unavailable, fetches from RSS feeds directly

The server automatically filters results from only trusted, reputable news sources.

📝 License

MIT License - Free to use and modify.