Weather MCP Server

A lightweight Model Context Protocol (MCP) server that gives AI assistants (like Claude) the ability to fetch real-time weather data for any city using the OpenWeatherMap API.

What It Does

This MCP server exposes a single tool — get_weather — that an AI assistant can call to retrieve the current weather conditions for any city in the world.

Example response:

The weather in London is light rain with 13°C.

Tech Stack

Python — core language
FastMCP — framework for building MCP servers quickly
OpenWeatherMap API — weather data source
Requests — HTTP client

Getting Started

1. Clone the Repository

git clone https://github.com/Tarun-004/weather-mcp.git
cd weather-mcp

2. Install Dependencies

pip install fastmcp requests

3. Add Your API Key

Get a free API key from OpenWeatherMap, then open server.py and replace the placeholder:

API_KEY = "your_openweathermap_api_key_here"

Never commit your API key to GitHub. Consider using a .env file and the python-dotenv package to keep it safe.

4. Run the Server

python server.py

MCP Configuration

To connect this server to an MCP-compatible client (e.g., Claude Desktop), add the following to your MCP config file:

{
  "mcpServers": {
    "weather": {
      "command": "python",
      "args": ["server.py"]
    }
  }
}

Available Tool

`get_weather`

Fetches the current weather for a given city.

Parameter	Type	Description
`city`	string	Name of the city (e.g., `"Tokyo"`)

Returns: A plain-text string with the weather description and temperature in Celsius.

Ideas for Future Improvements

Add support for forecasts (5-day, hourly)
Return humidity, wind speed, and UV index
Support coordinates (lat/lon) in addition to city name
Use environment variables for the API key
Add error handling for invalid city names

weather mcp