Weather MCP Server

What is Weather MCP Server?

Weather MCP Server is a Model Context Protocol (MCP) server implementation that provides weather alerts for US states using the National Weather Service API. It is built with the MCP Python SDK and is intended for developers integrating weather data into AI assistants, CLI tools, or custom applications.

How to use Weather MCP Server?

Install dependencies via pip install -r mcpserver/requirements.txt or pull the Docker image ksharma9719/weather-mcp-server. Run the server locally with python weather.py or in Docker with docker run -p 8000:8000 ksharma9719/weather-mcp-server. Invoke the included get_alerts tool by providing a two-letter US state code (e.g., CA). Connect using any of the provided client examples (stdio, SSE, or LLM‑powered CLI).

Key features of Weather MCP Server

• Provides weather alerts for US states via the National Weather Service API
• Supports stdio and SSE (Server-Sent Events) transport
• Includes an LLM-powered CLI client using Groq
• Offers Docker containerization for easy deployment
• Integrates with Claude Desktop and Cursor IDE
• Built-in conversation memory support

Use cases of Weather MCP Server

• Fetching active weather alerts for a specific US state
• Integrating real-time weather data into an LLM-based assistant
• Automating weather notifications through an MCP-compatible client
• Testing or demonstrating custom MCP server implementations
• Building a containerized weather alert service for cloud deployment

FAQ from Weather MCP Server

What are the runtime requirements?

Python 3.11 or higher and the uv package manager are required for local development. Docker is optional but recommended for containerized use.

How do I get weather alerts for a state?

Call the get_alerts tool with the state parameter set to a two-letter US state code (e.g., "CA" for California).

Does the server need an external API key?

The National Weather Service API used for alerts requires no key. An optional GROQ_API_KEY environment variable is needed only if you want to use the LLM‑powered CLI client.

Can I run Weather MCP Server in Docker?

Yes. Pull the pre-built image from Docker Hub (ksharma9719/weather-mcp-server) or build locally using the provided Dockerfile in the mcpserver directory.

What transport options are available?

The server supports both stdio and SSE (Server-Sent Events) transports. Example clients for both are included in the repository.