MCP weather server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP weather server What's the forecast for Lisbon on Saturday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP weather server (Python)
A minimal Model Context Protocol server with one tool, get_forecast, that answers
"what's the weather in a city on a day?" using the free Open-Meteo API (no key needed).
It's the code from the video How to Build an MCP Server in Python (From Scratch): [VIDEO LINK]
Claude Desktop --(MCP over stdio)--> weather.py --(HTTPS)--> Open-MeteoRequirements
Python 3.10 or newer
Claude Desktop, or any other MCP host
Related MCP server: Weather MCP Server
Run it
uv syncTest it on its own in the MCP Inspector (a local web page for trying out servers):
uv run mcp dev weather.pyIn the Inspector: Connect, then Tools and List Tools, then pick get_forecast, enter a city (Lisbon) and a date
within the next 16 days (YYYY-MM-DD), and click Run Tool.
Or test it from the terminal, the way a host talks to it (lists the tools, then calls the tool twice):
uv run python check_client.pyConnect it to Claude Desktop
Find your full paths:
which uv(on Windowswhere uv), andpwdin this folder.Open Claude Desktop's config file (Claude Desktop: Settings, Developer, Edit Config), or create it if it's missing:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add the
weatherentry fromclaude_desktop_config.example.jsoninsidemcpServers, with your two paths. Keep any servers already there.Quit Claude Desktop completely and reopen it. Ask: Is it sunny in Lisbon on Saturday?
Claude asks for your permission before it runs the tool, and shows the arguments it chose.
If the tool doesn't appear
The path must be absolute.
--directoryneeds the full path to this folder.Claude may not find
uv. Use the full path fromwhich uvascommand.Nothing may print to stdout. Over stdio, stdout carries the protocol messages; a stray
print()breaks them. Log withlogging(it goes to stderr) instead.
Claude Desktop's own log for the server is in ~/Library/Logs/Claude/mcp-server-weather.log (macOS).
How it works
MCPServer("weather")is the server;@mcp.tool()turnsget_forecastinto a tool.The type hints (
city: str, day: str) become the tool's input schema; the docstring becomes the description the model reads.The tool looks the city up with Open-Meteo's geocoding API, gets the daily forecast, and returns one short sentence, such as
Rainy, 20 °C on 2026-11-07.An unknown city returns a message instead of raising an error, so the model can tell the user.
Credits
Weather data by Open-Meteo, free for non-commercial use. Built with the MCP Python SDK.
License
MIT, see LICENSE.
Available Tools
1 toolget_forecastA
Get the weather forecast for a city on one day.
Args: city: City name, for example Lisbon day: Date as YYYY-MM-DD, within the next 16 days
Inputs: day (required), city (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With a single tool there is nothing to confuse it with; the purpose (daily forecast for a city) is unambiguous. An agent cannot misselect among tools here.
get_forecast follows a clear verb_noun convention, though with only one tool there is no pattern to actually verify. It is readable and predictable, but consistency is untested.
One tool is thin even for a narrowly scoped weather server; users would reasonably expect current conditions or multi-day output. It is not mismatched to the stated purpose, but it is on the sparse edge.
The surface covers only a single-day forecast, with no tool for current conditions, multi-day ranges, alerts, or location lookup/geocoding. These are standard weather operations that agents would commonly need and cannot work around with this set.
Related MCP Connectors
Current weather and forecast lookup as an agent tool.
Get current weather for any city and create images from your prompts. Streamline planning, reports…
Weather forecast for any city, UV index, sunrise and sunset, pollen and air quality. Free, no key.
Global weather via Open-Meteo: forecast, historical, marine, air quality, geocoding, elevation.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to get current weather information for any city using the Open-Meteo API. Provides detailed meteorological data including temperature, precipitation, day/night status, and hourly forecasts through natural language queries.ISC
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to retrieve 24-hour weather forecasts and city information through natural language queries using city names or coordinates.MIT
- FlicenseNot gradedqualityDmaintenanceProvides current weather and multi-day forecasts for any city using the Open-Meteo API, with natural language city names and optional forecast duration.-
- FlicenseNot gradedqualityDmaintenanceProvides weather forecast tools using Open-Meteo, enabling users to get current conditions, multi-day forecasts, and umbrella recommendations through natural language queries.-