trackmcp
Back to directory
hitechdk

weather-ai-agent

View on GitHub

AI agent that retrieves weather data from the MCP server to provide automated forecasts. Ideal for integration into weather-related applications.

0 stars PythonSearch & Data Retrieval Updated Apr 4, 2025

Documentation

Gemini API with MCP Tool Integration

This project demonstrates how to integrate the Google Gemini API with custom tools managed by the MCP (Multi-Cloud Platform) framework. It uses the Gemini API to process natural language queries, and leverages MCP tools to execute specific actions based on the query's intent.

Prerequisites

Before running this project, ensure you have the following:

  • Python 3.7 or higher
  • A Google Cloud project with the Gemini API enabled and an API key.
  • An MCP environment set up with the necessary tools.
  • `.env` file with the following environment variables:
code
GEMINI_API_KEY=
    GEMINI_MODEL=
    MCP_RUNNER=
    MCP_SCRIPT=

Installation

1. Clone the repository:

bash
git clone 
    cd

2. Create a virtual environment (recommended):

bash
python3 -m venv venv
    source venv/bin/activate  # On macOS/Linux

3. Install the required dependencies using `uv`:

bash
uv pip install dotenv google-generativeai mcp
    uv add "mcp[cli]" httpx
    uv pip install python-dotenv google-generativeai mcp

4. Create a `.env` file in the project root and add your environment variables.

code
GEMINI_API_KEY=your_api_key_here
   GEMINI_MODEL=gemini-pro
   MCP_RUNNER=path_to_mcp_runner
   MCP_SCRIPT=path_to_mcp_script

Usage

To run the application, execute the following command:

bash
python main.py

How It Works

1. The application loads environment variables and validates their presence

2. Establishes a connection with the MCP client

3. Retrieves available tools from the MCP session

4. Sends the prompt to Gemini's API along with tool definitions

5. Processes any tool calls made by the model

6. Returns the final response that includes results from tool calls

Customization

To customize the prompt or behavior:

1. Modify the `prompt` variable with your desired text

2. Adjust the `get_contents()` function to change how prompts are formatted

3. Extend `process_response()` to handle different response types

License

MIT License

Frequently asked questions

What is weather-ai-agent?

weather-ai-agent is AI agent that retrieves weather data from the MCP server to provide automated forecasts. Ideal for integration into weather-related applications.

How do I install weather-ai-agent?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is weather-ai-agent open source?

Yes — it is hosted on GitHub at https://github.com/hitechdk/weather-ai-agent.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP