MCP Weather Server Wsk

🚀 MCP Weather Server

An MCP (Model Context Protocol) server that provides weather information for the United States, utilizing the National Weather Service API. This server enables Claude and other MCP-compatible AI assistants to access real-time weather data.

🚀 Quick Start

The MCP Weather Server is an MCP (Model Context Protocol) server that offers weather information for the United States by leveraging the National Weather Service API. It allows Claude and other MCP-compatible AI assistants to access real-time weather data.

✨ Features

• Weather Alerts: Retrieve current weather alerts for any U.S. state.
• Weather Forecasts: Obtain detailed weather forecasts for any location in the United States based on latitude and longitude.

📦 Installation

For Users

Use Claude or other MCP-compatible AI assistants:

# Install from PyPI
pip install mcp-weather

# Or use uv to install
uv pip install mcp-weather

For Developers

Set up the development environment:

# Clone the repository
git clone https://github.com/michael7736/mcp-weather.git
cd mcp-weather

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -e ".[dev]"

📚 Documentation

Cline (VS Code Extension)

Add the following content to your Cline MCP settings file (cline_mcp_settings.json):

{
  "mcpServers": {
    "weather": {
      "command": "mcp-weather",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Claude Desktop App

Add the following content to your Claude desktop configuration file (claude_desktop_config.json):

{
  "mcpServers": {
    "weather": {
      "command": "mcp-weather",
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 Usage Examples

Basic Usage

After configuration, you can ask Claude or other MCP-compatible AI assistants weather-related questions:

• “What are the current weather alerts in CA state?”
• “What's the weather forecast for San Francisco?” (The assistant will use the coordinates of San Francisco)

🚀 Publishing

To publish this package to PyPI:

1. Make sure you have the latest build tools:

   pip install --upgrade build twine
   

2. Build the package:

   python -m build
   

3. Upload to PyPI:

   python -m twine upload dist/*
   

📄 License

This project is licensed under the MIT License. For detailed information, please refer to the LICENSE file.