Weather MCP Server logo

Weather MCP Server

by jameskanyiri

A simple MCP server that provides weather information using the National Weather Service API. It exposes two tools: `get_alerts` and `get_forecast`.

View on GitHub

Last updated: N/A

What is Weather MCP Server?

The Weather MCP Server is a Model Control Protocol server designed to provide weather information by leveraging the National Weather Service (NWS) API. It allows users to retrieve weather alerts for US states and forecasts for specific locations.

How to use Weather MCP Server?

To use the server, first install the prerequisites (Python 3.10+ and uv or pip). Then, clone the repository, set up your Python environment, and run the server using mcp dev main.py. Configure your Claude for Desktop app by adding the server configuration to claude_desktop_config.json with the correct absolute path to the project. Restart Claude for Desktop and use the hammer icon to access the get_alerts and get_forecast tools.

Key features of Weather MCP Server

  • Provides weather alerts for US states

  • Provides weather forecasts for specific locations

  • Uses the National Weather Service API

  • Easy to install and configure

  • Integrates with Claude for Desktop via MCP

Use cases of Weather MCP Server

  • Integrating weather information into Claude for Desktop workflows

  • Retrieving weather alerts for specific regions

  • Getting weather forecasts for planning purposes

  • Automating weather data retrieval

  • Building weather-aware applications

FAQ from Weather MCP Server

How do I install the server?

Clone the repository, set up a Python virtual environment with uv or pip, and install the dependencies using uv add "mcp[cli]" httpx or pip install "mcp[cli]" httpx.

How do I run the server?

Run the server using the command mcp dev main.py.

How do I configure Claude for Desktop to use this server?

Add the server configuration to ~/Library/Application Support/Claude/claude_desktop_config.json, ensuring the correct absolute path to the project is specified.

What tools are available?

The server provides two tools: get_alerts (to get weather alerts for a US state) and get_forecast (to get weather forecast for a specific location).

What do I do if the server isn't being picked up by Claude for Desktop?

Make sure the configuration file path is correct, verify the absolute path in the configuration, ensure all dependencies are installed, and try restarting Claude for Desktop.