Weather MCP Server

This repository contains a weather information service built using the MCP (Model-Completion-Protocol) framework. The service provides weather forecasts for any city by leveraging the National Weather Service (NWS) API.

Features

- Geocode city names to latitude/longitude coordinates
- Fetch weather data from the National Weather Service API
- Get detailed weather forecasts including temperature, conditions, and wind information
- Modular design with separate tools for each step of the process

Available MCP Tool

- get_weather: Get complete weather information for a city

Installation

We recommend using uv to manage your Python projects:

uv add "mcp[cli]"

Alternatively:

pip install mcp

Usage

Test the MCP Server Locally

To test the MCP server locally, use:

mcp dev weather.py

Use with Claude Desktop

To use this weather server with Claude Desktop, add the following configuration to your Claude Desktop config:

{
  "mcpServers": {
    "my_python_server": {
      "command": "/Users/<user_name>/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/<user_name>/<git_repository_path>",
        "run",
        "weather.py"
      ]
    }
  }
}

Make sure to replace the directories with your own path: </Users/user_name/Your_directory>

Example

Once configured, you can ask Claude questions like:
- "What's the weather in San Francisco?"
- "How's the weather in New York City?"
- "Get me the weather forecast for Chicago"

Claude will use the MCP server to fetch and display the weather information.

License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License (CC BY-NC 4.0). See the LICENSE.md file for details.