Weather MCP Server

This is a sample MCP (Messaging and Compute Platform) server for a weather application, designed for the Puch AI Hackathon. It provides a basic structure for integrating with a weather API and includes the required validate and resume endpoints.

Prerequisites

Before you begin, ensure you have the following installed:

• Python 3.9+
• Docker (for containerized deployment)
• An API key from a weather service provider like OpenWeatherMap.

Getting Started

Follow these steps to get the project up and running on your local machine.

1. Clone the repository

git clone <repository_url>
cd weather_mcp

2. Set up environment variables

The application requires a WEATHER_API_KEY to be set as an environment variable.

On macOS/Linux:

export WEATHER_API_KEY='your_weather_api_key'
export MY_NUMBER='919876543210'

On Windows:

$env:WEATHER_API_KEY='your_weather_api_key'
$env:MY_NUMBER='919876543210'

Alternatively, you can create a .env file in the root of the project and add the following lines. The .gitignore file is already configured to ignore this file.

WEATHER_API_KEY='your_weather_api_key'
MY_NUMBER='919876543210'

Note: The current app.py does not automatically load .env files. You would need to add a library like python-dotenv for that. Also, make sure to replace 919876543210 with your actual phone number in the required format.

3. Install dependencies

It's recommended to use a virtual environment.

python3 -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
pip install -r requirements.txt

4. Run the application

flask run

The server will start on http://127.0.0.1:5000.

Deployment to Render

This project is ready to be deployed to Render using Docker.

1. Push your code to a GitHub repository.
2. Create a new "Web Service" on Render and connect it to your GitHub repository.
3. Choose the "Docker" environment. Render will automatically detect the Dockerfile.
4. Add your WEATHER_API_KEY as an environment variable in the Render dashboard.
5. Deploy! Render will build and deploy your application. You will get a public URL for your service.

API Endpoints

All endpoints are prefixed with /mcp.

/mcp

• Method: GET
• Description: A simple endpoint to check if the server is running.
• Response:

  {
    "message": "Welcome to the Weather MCP server!"
  }
  

/mcp/get_current_weather

• Method: POST
• Description: Gets the current weather for a city.
• Request Body:

  {
    "city": "London"
  }
  

• Response: The JSON response from the OpenWeatherMap API.

/mcp/get_weather_forecast

• Method: POST
• Description: Gets the weather forecast for a city.
• Request Body:

  {
    "city": "Paris",
    "days": 3
  }
  

• Response: The JSON response from the OpenWeatherMap API.

/mcp/validate

• Method: POST
• Description: A placeholder for the hackathon's validate endpoint.
• Request Body:

  {
    "phone_number": "1234567890",
    "resume_summary": "A brief summary of a resume."
  }
  

/mcp/resume

• Method: POST
• Description: A placeholder for the hackathon's resume endpoint.
• Request Body: (Currently none)

Connecting to Puch AI

Once deployed, you should be able to connect your MCP server to Puch AI using the command mentioned in the hackathon instructions. It will likely be something like this, executed in WhatsApp:

/mcp connect <your_render_url>/mcp <your_auth_token>

Make sure to replace <your_render_url> with the URL provided by Render and <your_auth_token> with the token provided by the hackathon organizers. Always refer to the official hackathon documentation for the exact command and procedure.