MCP Weather Server

by SarveshChandak

199 downloads Not rated yet
GitHub

About

# MCP Weather Server This project is a weather server built using the MCP (Model Context Protocol) framework. It provides tools to fetch weather alerts and forecasts for specific locations in the United States using the National Weather Service (NWS) API. ## Features - **Get Weather Alerts**: Retrieve active weather…

Explore

- Get Weather Alerts: Retrieve active weather alerts for a specific US state.
- Get Weather Forecast: Fetch detailed weather forecasts for a specific latitude and longitude.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Weather Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Clone the repository:

   git clone <repository-url>

2. Navigate to the project directory:
   cd MCP Server/weather

3. Install dependencies:
   pip install -r requirements.txt

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp weather server": {
            "MCP-Server-Weather-Alerts": {
                "command": "python",
                "args": [
                    "weather.py"
                ]
            }
        }
    }
}

McpServers

{
    "MCP-Server-Weather-Alerts": {
        "command": "python",
        "args": [
            "weather.py"
        ]
    }
}

This project is a weather server built using the MCP (Model Context Protocol) framework. It provides tools to fetch weather alerts and forecasts for specific locations in the United States using the National Weather Service (NWS) API.

Features

- Get Weather Alerts: Retrieve active weather alerts for a specific US state.
- Get Weather Forecast: Fetch detailed weather forecasts for a specific latitude and longitude.

Installation

1. Clone the repository:

   git clone <repository-url>

2. Navigate to the project directory:
   cd MCP Server/weather

3. Install dependencies:
   pip install -r requirements.txt

Usage

Run the Server

Start the MCP weather server:

python weather.py

If the server and client are on the same machine, use the stdio transport:

uv run weather.py

Tools

1. Get Weather Alerts
Fetch active weather alerts for a US state using the get_alerts tool.

Arguments:
- state: Two-letter US state code (e.g., CA for California, NY for New York).

Example:

{
"tool": "get_alerts",
"args": {
"state": "CA"
}
}

2. Get Weather Forecast
Fetch a detailed weather forecast for a specific location using the get_forecast tool.

Arguments:
- latitude: Latitude of the location (e.g., 34.0522 for Los Angeles).
- longitude: Longitude of the location (e.g., -118.2437 for Los Angeles).

Example:

{
"tool": "get_forecast",
"args": {
"latitude": 34.0522,
"longitude": -118.2437
}
}

Automatic Invocation by LLM

These tools are designed to be automatically invoked by a Language Model (LLM) through the client whenever required. The client can seamlessly interact with the server to fetch weather alerts or forecasts based on user queries.

Contributing

Feel free to submit issues or pull requests to improve the project.

License

This project is licensed under the MIT License.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.