Weather MCP Server

A powerful weather information server built with FastMCP that provides weather alerts and tools through multiple interfaces.

Features

• 🌤️ Weather Alerts: Get real-time weather alerts for any US state

• 🔊 Echo Resource: Simple message echoing functionality

• 🖥️ Multiple Interfaces: Choose between MCP server or web interface

• 🎨 Beautiful UI: Modern, responsive web interface

Related MCP server: Node.js MCP Weather Server

Quick Start

Option 1: Interactive Launcher (Recommended)

python run_server.py

This will present you with options to run either the MCP server or web interface.

Option 2: Direct Web Interface

python server/web_interface.py

Then open your browser to: http://localhost:8000

Option 3: MCP Server Only

python main.py

Installation

1. Install dependencies:

   uv sync

2. Run the server:

   python run_server.py

Usage

Web Interface

1. Start the web interface

2. Open http://localhost:8000 in your browser

3. Use the forms to:

   • Get weather alerts for a US state (e.g., CA, NY, TX)

   • Echo messages through the resource system

MCP Server

The MCP server provides these tools:

• get_alerts(state): Get weather alerts for a US state

  • state: Two-letter US state code (e.g., "CA", "NY")

• echo_resource(message): Echo a message as a resource

  • message: Any text message to echo

API Endpoints

• GET /: Main web interface

• POST /api/alerts: Get weather alerts (form data: state)

• POST /api/echo: Echo a message (form data: message)

Dependencies

• mcp[cli]>=1.13.0: MCP server framework

• fastapi>=0.104.0: Web framework

• uvicorn[standard]>=0.24.0: ASGI server

• httpx>=0.25.0: HTTP client

• python-multipart>=0.0.6: Form data handling

Project Structure

secondproject/
├── main.py                 # MCP server entry point
├── run_server.py          # Interactive launcher
├── server/
│   ├── weather.py         # MCP server implementation
│   └── web_interface.py   # Web interface
├── pyproject.toml         # Project configuration
└── README.md              # This file

Troubleshooting

Common Issues

1. Port already in use: Change the port in web_interface.py or stop other services

2. Dependencies missing: Run uv sync to install all dependencies

3. API errors: Check your internet connection for weather data

Getting Help

• Check the console output for error messages

• Ensure all dependencies are installed

• Verify Python version (requires 3.12+)

License

This project is open source and available under the MIT License.