Mediastack News MCP Server

A FastMCP server that exposes the Mediastack News API as MCP (Model Context Protocol) tools. This server can be used as a plug-and-play backend for Smithery.ai or any other MCP-compatible agent platform.

✨ Features

• get_latest_news: Fetches the most recent news stories with various filtering options.
• get_sources: Lists available news sources with filtering capabilities.

🚀 Installation

1. Clone this repository:

   hljs language-bash

   Copy

   git clone <repository-url>
   cd NewsMCP_with_MediastackAPI
   

2. Install the required Python packages:

   hljs language-bash

   Copy

   pip install -r requirements.txt
   

⚙️ Configuration

This server requires a Mediastack API key to function.

1. Get a free API key from mediastack.com.
2. Create a file named .env in the project's root directory.
3. Add your API key to this file in the following format:
   hljs language-ini

   Copy

   MEDIASTACK_API_KEY=your_api_key_here
   

The server will automatically load this environment variable when a tool is called.

💻 Running Locally

To start the MCP server, run the following command:

python server.py

By default, the server will start on http://0.0.0.0:8080.

🛠️ Available Tools

1. get_latest_news

Fetches the most recent news stories from Mediastack.

Parameters:

• keywords (Optional): Search terms to filter news.
• sources (Optional): News sources, comma-separated (e.g., "cnn,bbc").
• countries (Optional): Country codes, comma-separated (e.g., "us,gb").
• languages (Optional): Language codes, comma-separated (e.g., "en,fr").
• categories (Optional): News categories, comma-separated.
• date (Optional): A specific date or date range (YYYY-MM-DD).
• sort (Optional): Sort order (published_desc, published_asc, popularity).
• limit (Optional): Maximum number of results to return (default: 25, max: 100).
• offset (Optional): Pagination offset.

2. get_sources

Lists available news sources from Mediastack.

Parameters:

• search (Optional): A search term to filter sources.
• sources (Optional): Specific sources, comma-separated.
• countries (Optional): Country codes, comma-separated.
• languages (Optional): Language codes, comma-separated.
• categories (Optional): News categories, comma-separated.
• limit (Optional): Maximum number of results to return (default: 25, max: 100).
• offset (Optional): Pagination offset.

☁️ Deployment on Smithery.ai

1. Push this repository to GitHub.
2. Connect your GitHub repository to Smithery.ai.
3. Smithery will automatically detect the smithery.yaml configuration.
4. Set your MEDIASTACK_API_KEY in Smithery's environment variables.
5. Deploy and start using the MCP tools.

For more information, visit the Smithery.ai Documentation.

📂 Project Structure

.
├── app.py           # MCP tool definitions
├── server.py        # FastMCP server setup
├── requirements.txt # Python dependencies
├── smithery.yaml    # Smithery deployment configuration
├── Dockerfile       # Instructions for building a Docker image
├── LICENSE          # Project license
├── .env             # (Local) Environment variables
└── README.md        # This file

📄 License

This project is licensed under the MIT License.