MCP ExplorerExplorer

Weather

@oyzh888on 9 months ago
1 MIT
FreeCommunity
AI Systems
This is a tutorial repository about MCP (Minecraft Coder Pack) server and client.

Overview

What is Weather

Weather is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service API.

Use cases

Use cases include providing weather alerts for specific states, delivering localized weather forecasts for cities, and integrating weather data into various applications.

How to use

To use the weather server, first create and activate a virtual environment, then install the required dependencies. Run the server using the command ‘uv run weather-server’. You can access weather alerts and forecasts using the provided functions.

Key features

Key features include getting weather alerts for US states and obtaining detailed weather forecasts for specific locations.

Where to use

The weather server can be used in applications that require real-time weather data, such as mobile apps, web applications, and desktop software.

Content

Weather MCP Server

This is a Model Context Protocol (MCP) server that provides weather information using the National Weather Service API.

Project Structure

weather/
├── mcp-server/           # MCP server implementation
│   └── weather.py       # Main server code
├── pyproject.toml       # Project configuration and dependencies
└── README.md           # This file

Features

  • Get weather alerts for US states
  • Get detailed weather forecasts for specific locations

Prerequisites

  • Python 3.12 or higher
  • uv package manager

Installation

  1. Create and activate a virtual environment:
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
  1. Install dependencies:
uv pip install -e .

Usage

Run the server:

uv run weather-server

The server exposes two tools:

  1. get_alerts(state): Get weather alerts for a US state

    • Example: get_alerts("CA") for California alerts
  2. get_forecast(latitude, longitude): Get weather forecast for a location

    • Example: get_forecast(38.5816, -121.4944) for Sacramento, CA

Configuration

To use this server with Claude for Desktop:

  1. Open ~/Library/Application Support/Claude/claude_desktop_config.json
  2. Add the following configuration:
{
  "mcpServers": {
    "weather": {
      "command": "/Users/zhihaoouyang/.local/bin/uv",
      "args": [
        "--directory",
        "/Users/zhihaoouyang/Desktop/code/weather",
        "run",
        "weather-server"
      ]
    }
  }
}
  1. Restart Claude for Desktop

Note

This server uses the National Weather Service API, which only provides data for locations within the United States.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers