MCP Server - Weather and Stock Information Service

This MCP (Model Control Protocol) server provides real-time weather alerts, forecasts, stock market data, and news information through various API integrations.

Features

• Weather Alerts: Get active weather alerts for US states

• Weather Forecast: Get detailed weather forecasts for specific locations

• Stock Market Data: Access top gainers and losers in the US stock market

• Stock News and Sentiments: Get news and sentiment analysis for specific stocks

• General News: Search for news articles by keyword and date

Related MCP server: Node.js MCP Weather Server

Prerequisites

• Python 3.x

• uv package manager

• API Keys for:

  • Alpha Vantage (for stock data)

  • News API (for news data)

Setup

1. Clone the repository:

git clone https://github.com/suraj2906/mcpServer
cd mcpServer

2. Create a virtual environment and install dependencies:

uv venv
uv pip install -r requirements.txt

3. Create a .env file in the project root with your API keys:

ALPHA_VANTAGE_API_KEY=your_alpha_vantage_key
NEWS_API_KEY=your_news_api_key

Configuration

To use this MCP server with Claude, you need to add the following configuration to Claude's config file:

1. Open Claude's settings

2. Go to File > Settings > Developer > Edit Config

3. Add the following configuration:

{
    "mcpServers": {
        "weatherAndStock": {
            "command": "uv",
            "args": [
                "--directory",
                "YOUR\\REPOSITORY\\PATH",
                "run",
                "mcp-server.py"
            ]
        }
    }
}

Note: Make sure to adjust the path (C:\\Users\\asus\\code\\mcpServer) to match your actual project location.

Available Tools

Weather Tools

• get_weather_alerts(state): Get active weather alerts for a US state

  • Example: get_weather_alerts("CA")

• get_forecast(latitude, longitude): Get weather forecast for a location

  • Example: get_forecast(37.7749, -122.4194)

Stock Market Tools

• get_top_gainers_losers(): Get top gainers and losers in the US stock market

• get_news_and_sentiments(ticker): Get news and sentiment analysis for a stock

  • Example: get_news_and_sentiments("AAPL")

News Tools

• get_news_today(keyword, date): Get news articles for a keyword and date

  • Example: get_news_today("technology", "2024-03-20")

Error Handling

The server includes robust error handling for API requests and will return appropriate error messages if:

• API keys are missing

• API requests fail

• Invalid parameters are provided

• No data is found for the given criteria

Contributing

Feel free to submit issues and enhancement requests!