MCP US Weather Client/Server

@ankitmishralive

Basic information

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

MCP US Weather 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"
      ]
    }
  }
}

MCP US Weather Client/Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More Developer Tools MCP servers

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.

Codex Pets

astandrik

Public read-only MCP server for discovering, inspecting, installing, and sharing approved Codex-compatible animated pet packs.