MCP Second Project Weather Forecaster

🚀 Weather MCP Server

A powerful weather information server built with FastMCP, offering weather alerts and tools via multiple interfaces.

🚀 Quick Start

Option 1: Interactive Launcher (Recommended)

python run_server.py

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

Option 2: Direct Web Interface

python server/web_interface.py

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

Option 3: MCP Server Only

python main.py

✨ Features

• 🌤️ Weather Alerts: Receive real - time weather alerts for any US state.
• 🔊 Echo Resource: Enjoy simple message - echoing functionality.
• 🖥️ Multiple Interfaces: Select between the MCP server or the web interface.
• 🎨 Beautiful UI: Experience a modern and responsive web interface.

📦 Installation

1. Install dependencies:

   uv sync
   

2. Run the server:

   python run_server.py
   

💻 Usage Examples

Basic Usage - Web Interface

1. Start the web interface.
2. Open http://localhost:8000 in your browser.
3. Utilize the forms to:
   • Obtain weather alerts for a US state (e.g., CA, NY, TX).
   • Echo messages through the resource system.

Advanced Usage - MCP Server

The MCP server provides these tools:

• get_alerts(state): Retrieve 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.

📚 Documentation

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

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

• ⚠️ Important Note
  • If the port is already in use, change the port in web_interface.py or stop other services.
  • If dependencies are missing, run uv sync to install all dependencies.
  • If there are API errors, check your internet connection for weather data.

Getting Help

• 💡 Usage Tip
  • 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.