Weather MCP Server

Weather MCP Server

By ankushmehta123 GitHub

-

Overview

What is Weather MCP Server?

Weather MCP Server is a project that implements a Model Context Protocol (MCP) server, enabling AI assistants to interact with the National Weather Service (NWS) API for real-time weather alerts and forecasts.

How to use Weather MCP Server?

To use the Weather MCP Server, clone the repository, install the required dependencies, and run the main.py script. You can then interact with the server through an AI assistant like Claude to get weather-related information.

Key features of Weather MCP Server?

  • Retrieve active weather alerts for any US state.
  • Fetch weather forecasts based on latitude and longitude.
  • Utilizes the FastMCP framework for AI interaction.

Use cases of Weather MCP Server?

  1. Providing real-time weather updates to users.
  2. Integrating weather data into AI applications.
  3. Enhancing AI assistants with weather-related capabilities.

FAQ from Weather MCP Server?

  • What technologies are used in this project?

The project is built using Python, FastMCP, and httpx for asynchronous HTTP requests.

  • Is there a specific Python version required?

Yes, Python version 3.11.6 or higher is recommended.

  • How can I install the required packages?

You can install the required packages using pip with the command: pip install -r requirements.txt.

Content

Weather MCP Server

Overview

This project implements a Model Context Protocol (MCP) server that allows AI assistants (such as Claude) to interact with the National Weather Service (NWS) API. The server provides real-time weather alerts and forecasts for a given location.

Features

  • Retrieve active weather alerts for a given US state.
  • Fetch weather forecasts for a specified latitude and longitude.
  • Implements the FastMCP framework to expose tools for AI interaction.

Technologies Used

  • Python
  • FastMCP
  • httpx (for asynchronous HTTP requests)

Prerequisites

Before running this project, ensure you have:

  • Python installed (version 3.11.6 or higher recommended)
  • uv package manager (pip install uv)
  • httpx installed (pip install httpx)
  • fastmcp installed (pip install fastmcp)
  • Claude Desktop app

uv Package Manager Installation

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Add to PATH

Installation & Setup

  1. Clone the repository: git clone https://github.com/ankushmehta123/weather-mcp-server.git

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

  3. Configure your MCP server by adding the following to claude_desktop_config.json:

     "mcpServers": {
     "weather": {
         "command": "C:/Users/"enter_your_username"/.local/bin/uv.exe",
         "args": [
             "--directory",
             "directory_location of main.py",
             "run",
             "main.py"
         ]
     }
 }
}

Usage

Run main.py python main.py

Available API Tools

Open Claude Desktop, you would see: 2 MCP tools available (at right-side of the search-bar)

You can ask real-time weather-related questions to Claude now

No tools information available.
No content found.