Weather MCP Server

@jtwirly

About Weather MCP Server

No overview available yet

#weather-mcp #weather-server #weather-forecast

Config

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

{
  "mcpServers": {
    "weather-mcp-server-jtwirly": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

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 Weather MCP Server?

Weather MCP Server is a Model Context Protocol server that provides US weather forecasts and alerts through Claude for Desktop. It integrates with the National Weather Service (NWS) API to return detailed forecasts for any latitude/longitude and active alerts for any US state code.

How to use Weather MCP Server?

Install the server using the uv package manager, configure it in Claude for Desktop’s configuration file (claude_desktop_config.json) by specifying the uv command and the absolute path to the project directory. After restarting Claude, look for the hammer 🔨 icon and ask queries like “What’s the weather in Sacramento?” or “What are the active weather alerts in Texas?”

Key features of Weather MCP Server

get_forecast: Get detailed forecasts using latitude and longitude.
get_alerts: Retrieve active weather alerts for a US state.
Relies entirely on the public National Weather Service API.
Designed for use with Claude for Desktop.
Created as part of the MIT MCP Hackathon tutorial.

Use cases of Weather MCP Server

Ask Claude for the current weather forecast for any US location.
Ask Claude for active weather warnings or watches in a given state.
Integrate real‑time NWS data into conversational AI workflows.

FAQ from Weather MCP Server

What are the runtime requirements?

Python 3.10 or higher, the uv package manager, Claude for Desktop, and the MCP SDK 1.2.0 or higher. The httpx library is also required.

How do I configure the server in Claude for Desktop?

Edit the file ~/Library/Application Support/Claude/claude_desktop_config.json and add a weather entry under mcpServers with the path to uv and the project directory as shown in the README.

Where can I find logs if something goes wrong?

Claude’s logs are stored at ~/Library/Logs/Claude/mcp*.log. Ensure all paths in the configuration are absolute and that port 8001 is not in use.

Which API does the server use?

It uses the U.S. National Weather Service API (api.weather.gov) to fetch forecast grid data and active alerts. No API key is required.

Can I run the server independently of Claude?

Yes, you can verify it by running uv run weather.py from the project directory.

Frequently asked questions

What are the runtime requirements?

Python 3.10 or higher, the `uv` package manager, Claude for Desktop, and the MCP SDK 1.2.0 or higher. The `httpx` library is also required.

How do I configure the server in Claude for Desktop?

Edit the file `~/Library/Application Support/Claude/claude_desktop_config.json` and add a `weather` entry under `mcpServers` with the path to `uv` and the project directory as shown in the README.

Where can I find logs if something goes wrong?

Claude’s logs are stored at `~/Library/Logs/Claude/mcp*.log`. Ensure all paths in the configuration are absolute and that port 8001 is not in use.

Which API does the server use?

It uses the U.S. National Weather Service API (`api.weather.gov`) to fetch forecast grid data and active alerts. No API key is required.

Can I run the server independently of Claude?

Yes, you can verify it by running `uv run weather.py` from the project directory.

Comments

Basic information

More Media & Design MCP servers

MiniMax MCP

MiniMax-AI

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

1.5K