MCP US Weather Client/Server

@ankitmishralive

About MCP US Weather Client/Server

A simple MCP (Model Context Protocol) server that provides weather alert information for US states, leveraging the National Weather Service (NWS) API. It also includes an example client application that demonstrates how to interact with the MCP server using the mcp_use library.

#mcp #weather #api #client-server

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Hands-on-MCP": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "dev",
        "server/weather.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP US Weather Client/Server?

This repository contains a simple MCP (Model Context Protocol) server that provides weather alert information for US states by leveraging the National Weather Service (NWS) API. It also includes an example client application demonstrating how to interact with the MCP server using the mcp_use library and Langchain.

How to use MCP US Weather Client/Server?

Clone the repository, install dependencies with uv add -r requirements.txt, and create a .env file with your Groq API key. Start the server with uv run mcp dev server/weather.py and the client with uv run server/client.py. At the client prompt, type queries such as "Get weather alerts for CA, NY or NJ" and use exit, quit, or clear to manage the conversation.

Key features of MCP US Weather Client/Server

Fetches active weather alerts for any US state
Built using the fastmcp library for MCP server implementation
Includes a client with conversation memory
Integrates with Langchain for LLM interaction
Provides a get_alerts tool and get_config resource
Uses the public National Weather Service API (api.weather.gov)

Use cases of MCP US Weather Client/Server

Query weather alerts for one or multiple US states via natural language
Learn how to build and run an MCP server with fastmcp
Explore MCP client integration with Langchain and conversation memory
Demonstrate a full MCP ecosystem with a real-world public API

FAQ from MCP US Weather Client/Server

What tools and resources does the server expose?

The server exposes a get_alerts tool for fetching weather alerts by state and a get_config resource. These are defined in both the weather.py file and the weather.json configuration file.

What are the prerequisites and dependencies?

Python 3.7+, uv for dependency management, a Groq API key for the client, and the mcp_use library. The server itself connects to the public NWS API with no required authentication.

How do I configure the server and client?

Create a .env file in the root directory with GROQ_API_KEY=<your_key>. Ensure the server/weather.json file matches the tool and resource definitions in server/weather.py.

How do I run the server and client?

Start the server with uv run mcp dev server/weather.py and the client with uv run server/client.py. The client runs in an interactive prompt.

What data does the server use and where does it come from?

All weather alert data is fetched live from the National Weather Service API (api.weather.gov). No data is stored locally by the server.

Frequently asked questions

What tools and resources does the server expose?

The server exposes a `get_alerts` tool for fetching weather alerts by state and a `get_config` resource. These are defined in both the `weather.py` file and the `weather.json` configuration file.

What are the prerequisites and dependencies?

Python 3.7+, `uv` for dependency management, a Groq API key for the client, and the `mcp_use` library. The server itself connects to the public NWS API with no required authentication.

How do I configure the server and client?

Create a `.env` file in the root directory with `GROQ_API_KEY=<your_key>`. Ensure the `server/weather.json` file matches the tool and resource definitions in `server/weather.py`.

How do I run the server and client?

Start the server with `uv run mcp dev server/weather.py` and the client with `uv run server/client.py`. The client runs in an interactive prompt.

What data does the server use and where does it come from?

All weather alert data is fetched live from the National Weather Service API (api.weather.gov). No data is stored locally by the server.

Comments

Basic information

More Developer Tools MCP servers

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

TaskerArmy Agent

TaskerArmy

Ask Claude or ChatGPT what Shopify theme optimization tasks are pending on your store, a remote MCP server for TaskerArmy Agent accounts.

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K