Weather MCP Server

Weather AI Chatbot with MCP Integration

A Python-based AI chatbot that uses OpenAI's GPT model and integrates with a Model Context Protocol (MCP) server to provide real-time weather information from OpenWeatherMap API.

Features

• 🤖 AI-Powered Chatbot: Uses OpenAI's GPT-3.5-turbo for natural language processing
• 🌤️ Real-time Weather Data: Access current weather and forecasts for any city worldwide
• 🔌 MCP Integration: Implements Model Context Protocol for modular service architecture
• 💬 Conversational Interface: Natural language interaction with weather queries
• 📊 Detailed Weather Information: Temperature, humidity, wind, pressure, and more
• 🗓️ Weather Forecasts: Multi-day weather predictions
• 🔄 Conversation Memory: Maintains context across conversation turns

Architecture

Prerequisites

• Python 3.8 or higher
• OpenAI API key
• OpenWeatherMap API key

Installation

1. Clone or download the project files
2. Install dependencies:
   pip install -r requirements.txt
3. Set up environment variables:
   cp env.example .env
   Edit .env and add your API keys:
   OPENAI_API_KEY=your_openai_api_key_here OPENWEATHER_API_KEY=your_openweather_api_key_here MCP_SERVER_HOST=localhost MCP_SERVER_PORT=8000

Getting API Keys

OpenAI API Key

1. Go to OpenAI Platform
2. Sign up or log in
3. Navigate to API Keys section
4. Create a new API key
5. Copy the key to your .env file

OpenWeatherMap API Key

1. Go to OpenWeatherMap
2. Sign up for a free account
3. Navigate to API Keys section
4. Generate a new API key
5. Copy the key to your .env file

Usage

Starting the MCP Weather Server

First, start the MCP server that provides weather data:

The server will start on http://localhost:8000 by default.

Running the Chatbot

In a new terminal, start the chatbot:

Example Conversations

Available Commands

• quit, exit, bye - End the conversation
• reset - Clear conversation history

Weather Query Examples

The chatbot can understand various ways to ask about weather:

• "What's the weather in Paris?"
• "How's the weather in Tokyo?"
• "Weather forecast for London"
• "Temperature in New York"
• "What's the weather like in Sydney?"
• "Forecast for Berlin this week"
• "Weather in Toronto tomorrow"

MCP Server Endpoints

The MCP server provides the following endpoints:

• POST /mcp - Handle MCP requests
• GET /capabilities - Get server capabilities

Available Methods

1. weather/get_current
   • Parameters: city (required), country_code (optional)
   • Returns: Current weather information
2. weather/get_forecast
   • Parameters: city (required), country_code (optional), days (optional, max 5)
   • Returns: Weather forecast information

Testing

You can test the MCP client independently:

This will test the weather service with sample requests.

Error Handling

The system includes comprehensive error handling for:

• API connection issues
• Invalid city names
• Missing API keys
• Network timeouts
• Malformed responses

Configuration

You can customize the following settings in your .env file:

• MCP_SERVER_HOST - MCP server hostname (default: localhost)
• MCP_SERVER_PORT - MCP server port (default: 8000)
• OPENAI_API_KEY - Your OpenAI API key
• OPENWEATHER_API_KEY - Your OpenWeatherMap API key

Troubleshooting

Common Issues

1. "OPENAI_API_KEY environment variable is required"
   • Make sure you've set up your .env file correctly
   • Verify your OpenAI API key is valid
2. "OPENWEATHER_API_KEY environment variable is required"
   • Ensure your OpenWeatherMap API key is in the .env file
   • Check that the API key is active
3. "Failed to connect to MCP server"
   • Make sure the MCP server is running (python weather_mcp_server.py)
   • Check that the host and port settings are correct
4. "City not found" errors
   • Verify the city name spelling
   • Try adding a country code (e.g., "London, GB")

Debug Mode

To enable debug logging, modify the logging level in the Python files:

Contributing

Feel free to contribute to this project by:

1. Reporting bugs
2. Suggesting new features
3. Improving documentation
4. Adding new weather data sources

License

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

Acknowledgments

• OpenAI for providing the GPT API
• OpenWeatherMap for weather data
• The MCP community for the protocol specification